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A STUDY IN NUMBERS 


Number Systems (Bases) 


Why would we want to study numbers? Because, our computers 
only understand numbers. You may saying, “My computer knows 
Basic" or any of several other languages but, the truth of the 
matter is that it does not know or understand any language other 
than the assembly language of the Central Frocessing Unit 
(CFU). 

What 15 this fool (me) talking about? All languages used by 
any computer, except assembly, are referred to as ‘high level’ 
languages. High level languages come in two varieties, compiled 
and interpreted. Compiled languages are converted = (compiled) 
into the CPU’s assembly language and run as machine code and 
therefore quicker than interpreted languages. 

Interpreted languages are interpreted into assembly 
language at the time of execution. They still run as machine 
code but, much slower due to the interpreter processing time. 
Interpreted languages also run from a library of routines, which 
are slower by their very nature. 

the important point of this 1s that all programs are stored 
in the computer memory as numbers. Look at your Sinclair 
character tables. The Basic command PRINT is really the number 
243. Since all programs are numbers, it behooves us ta know a 
littie bit about them. 1 don’t know about you but, ft hate 
machines that are smarter than I am! 

We do not need to learn assembly programming to use our 
computers however, understanding the numbers and why different 
bases are used will help us be more efficient programmers. Of 
course many of you may have desired to know more about machine 
code and been afraid to tackle it. After all, those long Hex 
(whatever that is) dumps in the magazines seldom make sense. Or 
maybe you have seen those Hexidecimal numbers and wondered why 
anyone would resort to such mutterings! If this discribes you, 
then perhaps the following study can be of help. 

If we wish to get intimate with some of the inner workings 
of our computer or before attempting to learn any Assembly 
Language (machine code), you will need to thoroughly understand 
three number systems or bases as they are properly called. There 
is a fourth base, Octal, which I will not discuss here as you 
will seldom encounter it. Octal will be found in the programming 
guides published by chip manufactures and can be useful however, 
we can do guite well without it for this study. Each base will 
be discussed separately however, I will make references back to 
Decimal, as that is the one we all use dailey. 


Decimal ‘(Base i) 


The first is Decimal (dec), or base 10 numbers. We are ail 
familiar with decimal as we use it every day to count our bags 
Of money and for various other tasks. Most of us learned in 
school that the columns of digits represent ones, tens, 
hundreds, etc. For example: 


arto 

meen 
ddne 
6555 6 


123 4 


What you may not recall is, each column represents 1@ £i(the 
base)raised to the power of the number of the column ast counted 
from right to left, starting at zero. Hows that for doubletalk”? 

Follow through this example, to see that 12354 decimal 
really means: 


10°02 = #4 = & 
14°11 = 1@*3 = 36 
18°22 = 106+#2 = 7200 
14° = 10800#*1 = 1000 
Total= 1234 


Study this carefully as it 15 the easiest example we will 
have and it must be understood or the rest will really seem like 
Greek to you. 

Before continuing, it bears mentioning that all bases are 
represented by the digits @ to Base-1l. Base 10 is therefore 
represented by the digits @ to 9. It is these digits which then 
represent a mutiple of a power of the base, as above (10°04). 
No digit can be greater than Base~1 because at the point iit 
equals the Base there is a carry to the next column. For 
instance, in base 10, 9+1=@0 and carry 1 to next column. All of 
this should be familiar to you but if you are like me, you 
haven’t given it much thought since school. No,Il wont say how 
long ago that was! 


Binary (Base 2) 


Now for the hard stuff, Binary (bin), or base 2 Following 
our discussion of the last paragraph, we can only represent 
binary numbers with the digits @ and 1 (remember base-1). This 
means our columns also must have meanings other than ones, tens, 
etc. They now become ones, twos, fours, eights, sixteens, etc., 
which are the powers of 2 (our base) instead of powers of 18. 
For example: 


As in our previous example, 1011 really means: 


2’ @ = 1%1 = 1 
2.1 = 2¥1 = 2? 
22 = 4x = O 
23 = B81 = B 
Total= 11 decimal 


Now you know why we count in decimal! You thought it was 
because we have ten fingers. Imagine having hands with two 
fingers on each hand. Binary would then seem as easy as decimal. 
If you have any difficulty with this, go back to the discussion 
on decimal and compare it with this one. Only the base is 
different. 

What you have just learned is how to convert binary to 
decimal. The procedure for converting decimal to binary is 
similar. Briefly, divide your number by the largest power of two 
not larger than your number. You continue this process with 
successively smaller powers of two until you have reached 2°, 
at which time there should not be a remainder. Write down (left 
te right) a il when the division is possible and a @ when not 
possible. Using our example of ii: 


Step Do Result 
1. 2°4=16 and 2°3=68 therefore, 
2"3 or 8 is the number we want. 


ee 2°3=8 and 11/8=1 remainder 3 1 

ie 2°2=4 and 3/4=@8@ remainder 3 16 
4A. 2°1=2 and 3/2=i remainder 1 i@1 
a <"@=1 and i1/1=1 remainder @ 1011 


&. We have now converted 11 decimal to 1811 binary 


Some of you may be wondering what the point of all this is. 
After all I barely passed math in school, why bother with this 
now? The point is, while decimal is more comfortable for us 
humans, binary better represents how our computer ‘thinks’. 

An explanation of the CFU is in order. This is background 
only to give you some understanding why the ‘smart’ computer 
doesn’t understand decimal. The CPU (which is the 788 in our 
Sincliairs) is merely a collection of transistors and transistors 
are simply electronic switches. For those of you who know 
better, please bear with me, my end will justify the extreme 
over simplicatiom. We all know that a switch can either be on or 
off. Binary allows us to represent the on/off states with one 
and zero, respectively. Not quite perfect but it works! 

Most Binary numbers you will see, will have eight digits or 
some multipie thereof. This is accomplished by padding out the 
number with leading zeros. For instance, 1811 binary would 
normally be written as @8001@11b. The reason for eight Binary 
adigITS (bits) is that eight bits make one byte. 

A byte 15 not what your neighbors’ dog puts on you. A byte 
is the ‘wordsize’ of your CPU. A word is the number of Obits 
handied as a complete unit by the CPU and is commonly referred 
to as a byte. The Z8H% is an eight bit CFU, therefore one 
byte=eight bits. Words and bytes are not exactly the same, but 
wili suffice here. You do not need to understand the internal 
workings of the CPU in order to understand binary numbers. 

Binary 1s most useful for graphics in Basic or masks in 
assembly. Untess you decide to learn assembly, you will seldom 


work directly in Binary due to the difficulty keeping the digits 
correct, which leads us to the next base.... 


Hexadecimal (Base 16) 


Now that we have mastered binary we can dig into the last 
of the three number systems. Hexidecimal (hex) or base 16 igs 
used because it works very well as a shorthand for that awful 
binary. I have provided several charts for easy conversion from 
hex to decimal and hex to binary or vice versa. So don’t leave 
now, things are about to make sense. 

One challenge we have with hex is that there are not enough 
digits for @ to base-i. We have ontiy @ to 9 which will work fine 
for the first ten digits. We need to improvise for the last six 
digits and someone far wiser than me (us?) has already solved 
our dilemna. The digits needed to represent 1@ to 15 are 46 ta F. 
The sixteen hex digits are now @, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, 
B, C, D, E& F. 

Now that we have the digits, we need to recognize the farm 
taken by hex numbers. Just as binary are usually eight digits 
jong, hex numbers are always two (or some multiple of two) 
digits long. This makes counting in hex as follows: 


@0,01,02,03,...,0A,08,0C,OD,0£,aF, 


Dee od a aya ores a-ece eiecene 7 De Tee Le. 
Wg 2 Ln do ane) ese cate eel oc eecere ce Se ee a ae 
1 Se eo ee ee ee ee eee ee seg Ol. 
ae ee ee re RP Re Re oe ee ee ae moe eae ee tae Se ecewe 
iQ ccweaw es eneer aan a ee pe ere Sona ee A 
A close look at the hex to decimal conversion chart will 


make this much clearer. 

You may occasionally see hex numbers that have an odd 
number of digits. The first digit will be a zero and the second 
a letter, such as OFFh. I do not use a leading zero however, be 
aware some assemblers require it, therefore you may see it. 

There is no need to go into the math needed to convert 
between hex and decimal as the chart provided will serve the 
purpose much better, easier and faster. Those of you interested 
in working out the details need only follow the examples’ for 
decimal and binary. Keep in mind the base is now 16 
therefore,the columns of digits will represent ones, sixteens, 
two hundredfifty-sixes, etc. 

All this brings us to what I mean by hex being a shorthand 
for binary and the reason we are even interested in hex. A close 
look at the hex to binary conversion chart will make this more 
obvious. You can readily see that four bits can be represented 
By one hex digit. For those of you who understood my ramblings 
about bytes, four bits is a small byte (also known in some 
circles as a nybble). Could I make this up? Therefore, we can 
represent any eight bit byte with only two hex digits. 

You may recognize that this is not that much better than 
decimal however, decimal cannot be converted to binary with the 
same ease as hex. Also, numbers larger than 255 will really 
create some headaches that hex helps scive (more on this in a 
minute). 


We now know how to write numbers in three bases, decimal, 
binary, and hex. In order to avoid confusion we need to make a 
proper designation of each. Thoughout this study we will suffix 
all binary numbers with a °b’ (1@8001@0@b) and all hex numbers 
with a “h’ (25h). Occasionally, you may see a ‘’d’ suffix on 
decimal numbers however, it 165 not needed as decimal is the 
default. We will do this even though some numnbers can obviously 
only be hex (FF). You must always be careful to follow this 
notation or you will create unneccessary confusion for all. 

You should take some time to practice using all the charts. 
Also, practice simple arithmetic in each base (add, sub, mult = & 
div). You can use the charts to check your answers. Before long 
you will be thinking in hex and binary as easily as you now do 
in decimal. 

Ok, let’s look at how numbers larger than 255 are stored 
and handled by the CPU. 

That's twice I mentioned 255 without an explanation. The 
reason 255 is a magic number is because it is base-i for base 
206 numbers. I am not going to boggle your mind with this number 
system as it is not needed by us, only the CFU uses it. Why 
in the world does the silly CPU use base 256? Let’s go back to 
our discusion of binary, bytes and related whatevers. Remember, 
we padded out our binary numbers to eight digits as one byte for 
the 480 is eight bits? The reason the CFU uses base 756 is ?°8 
= 256. Voila! On your own, figure out what 1211111111b means in 
decimal. 

We can actually store numbers between @ and 65535 by tieing 
two bytes together. This is done by the CFU automatically to 
generate addresses. The second byte is increased by a factor of 
426 as this is the number that generates a carry out of the 
#irst byte. For example: 


Mea a Sa ee i 


18606090690 8B 


Remember, 141 binary = @ and carry 1 just as 9%9+1 does in 
decimal. Work out the above problem yourself to see haw the 
result is achieved. You will notice we now have a number which 
is nine digits long. In truth, the actual number is 
BESBEGG1AGG0O000b because we are tieing two bytes together and 
each byte is padded out to eight digits. Since our number is now 
sixteen bits long, the largest number we can store is 2“16-1 or 
65535. 

You can now see why we need a shorthand for binary. Today, 
we rarely work with large binary numbers as it is too easy to 
err. We will not discuss binary numbers larger than eight digits 
either. If you decide to learn an assembly language, you will 
probably only use binary when working with the logic 
instructions. You may find it interesting that early programmers 
had to use only binary numbers and they were entered from a 
panel of switches instead of a keyboard. Today, using machine 
code is duck soup and hex is much easier to work with. 

What did I mean, ‘tie two bytes together and increase one 
of them by a factor of 2567’ Let’s assume our number is stored 
in byte 1 and byte 2. The formula to recover our number is: 


Feek byte 1 + Peek byte 2 * 256 


Looks a little familiar? You probably have seen something 
Similiar before and did not know what was happening. The byte we 
increase by the factor of 256 is called the high byte which 
makes the other byte the low byte. Using high/low nomenclature, 
our formula becomes: 


Peek low byte + Peek high byte * 256 


One pecularity designed into the CFU is that contrary to 
the number systems we have discussed, the CFU stores the low 
byte first. This must be kept in mind or you will not at all get 
the results you were trying to achieve. Scan the list of system 
variables in your Sinclair manual and use this formula on some 
of the 2 byte variables. The results are the address at which 
that area of memory begins. 

Review some of the areas of your Sinclair manual that did 
not make sense before. Especially the chapters on number 
systems, machine code, system variables, memory, and the 
appendices. There is a wealth of information there however, it 
is presented so poorly that it may not have made sense before. 
Then compare notes with this study and you will be well on the 
way to understanding machine code. 


—-END-— 
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BEGINNING 242380 MACHINE CODE 


LESSON 1 


Tim has asked me to write a continuing series on beginning 
480 machine code. I should like to hear from you what your 
specific needs are as well as your suggestions and comments. You 
can respond direct to me (address at end of articte) to avoid 
delay and extra work for Tim. 

We will be developing some machine code (MC) routines to be 
used as subroutines in a Basic program. This will aid the 
learning process as well as provide a useful goal. I am laboring 
under the assumption that you already have a good understanding 
of Basic. If not, you may wish to master Basic first, as it is a 
very powerful programing language all by its self. 

You may be asking, "What is machine code and why would I be 
interested in learning it?". Your answer very well may be you 
are not interested in which case you need read no further. 
However, if you are tired of your computer taking a coffee break 
when you ask it to perform some task, you may be interested in 
how MC can put some speed in your program, and end that coffee 
break sooner. 

What is machine code? Very simply, MC is the ‘’language’ 
understood by your computers’ Central Processing Unit (CPU). 
Each CPU has its own set of instructions which enable it to 
perform its task as housekeeper and communicate with the outside 
world (other devices). These instructions are permanently stored 
at birth in the CPU as numbers. We will be studying the Z78@ as 
it is the CPU Sinclair chose to use in our computers. 

I called the CPU, housekeeper, for a reason. The CPU is 
basicly dumb. It is the ’workhorse’ in your computer and can 
only perform general housekeeping chores. The ‘brains’ of the 
operation is the operating system and basic interpreter which is 
permanently stored in memory (ROM). Without the operating system 
the CPU is even more helpless than a newborn child. The CPU can 
only perform as instructed however, it will perform exactly as 
instructed which may not always be what is intended. More on 
this later. 

We need to pause a moment to define ROM, RAM, Peek and 
Poke. 

ROM and RAM are types of memory locations within your 
computer. ROM stands for Read Only Memory and RAM for Random 
Access Memory, niether of which explains their functions very 
well. All memory locations (addresses) can be thought of storage 
boxes. All memory may be examined ,however some of these boxes 
(ROM) cannot be altered while others (RAM) can be. This 
difference is all we will be concerned with here which brings us 
to Peek and Poke. 


Peek allows us to look at the contents of these boxes, as 
if they had glass tops. Poke is the command that places a number 
in the boxes (RAM only). Try Pokeing various numbers, no teddy 
bears or marbles, into a safe address (30,@@@ will do) and 
Peeking the location to see if you attain the results you 
expected. Try other locations if you think there is something 
magical about 30,06¢@. Safe locations on the TS10@@ are 
16509-32767 (16K) and on the TS2@68 are 26710-65535. Try an 
address @-16383 (ROM). Peek it first, then Poke, then Peek 
again. You cannot change the contents of ROM but, you are 
welcome to look inside as often as you wish. You can find the 
proper syntax for Peek and Poke in your Sinclair manual. 

I mentioned the instructions being stored in the CPU as 
numbers, we also will store our MC as numbers since that is all 
the CPU understands. Your computers’ operating system and basic 
interpreter are written in MC for this reason. For example, the 
CPU does not understand the basic command ’PRINT’. There is 
instead a subroutine of MC instructions (stored as numbers) in 
the basic interpreter of your computer which tell the CPU what 
steps are necessary to execute your ’PRINT’ command. 

To see what I mean, enter and run listing 1 on your 
computer. You are looking at the numbers (MC) stored in first 2@ 
bytes of ROM. Obviously, you thoroughly understand what they 
mean. Don’t worry I don’t understand them either but, the CPU 
does and thats the point. Those unintelligible numbers mean 
something to the CPU and shortly will mean something to us. 

You should notice that all the numbers are between @ and 
255. This is very important. For now, we need only know that @ 
to 255 represents the limit of numbers that can be stored in a 
Single byte. The reasons for this will be obvious later, when we 
discuss binary numbers. Try changing the values in line 19 to 
look at other locations. 

A quick scan of the Sinclair manual indicates how the 
computer stores numbers greater than 255. It ties two adjacent 
bytes together by increasing one of them by a factor of 256 
(2°8). Storing numbers this way means we can now use the numbers 
@ to 65535 (2°16). The number that we increase by the factor of 
256 is refered to as the high byte, making the other the low 
byte. The oddity in this is that the Z8@’s designers chose to 
store the low byte first. For example, let’s assume bytes 1 and 
¢ hold our number. The number held by these two bytes is: 


Peek (Byte 1) + 256 * Peek (Byte 2) 


You have probably seen this formula before and may have wondered 
what was happening. Many of the systems variables are stored in 
this manner as well as all addresses. Even addresses less than 
295 require two bytes storage. More on this later, also. 

One other point, all the numbers we have discussed thus far 
are in decimal (base 10) which is how most of us count. Science- 
tist and philosophers have debated why we use decimal numbers 
since approximately 1134 BC (before computers) and the general 
concensus, despite lack of empirical proof, is that it has some- 
thing to do with our having ten fingers (that has nothing to do 
with MC however, I thought you trivia buffs would want to know). 


In this series I will represent all MC with hexadecimal 
(base 16) numbers. This is not an effort to confuse you. I 
prefer using hexadecimal (hex) numbers for several resaons: 

. all numbers @ to 255 can be 
represented with two digits 
2. larger numbers can then be 
represented with a muliple 
of two digits 
3. Cleaner/easier screen displays 
4. less keystokes to enter MC 
>. @asier to use and understand 
the logic instructions 
my MC loader program handles 
hex numbers only 
many MC listings are presented 
in hex numbers 
personal preference, after all 
l’m writing this 
The fact that your computer only recognizes decimal numbers is 
not a problem. The computer is very good at conversions of this 
nature and I prefer to let it do them. 

Now that we know what the hieroglyphrics are called, what 
is hex? It is base 16 numbers. Just as we represent decimal 
numbers with the digits @-9, we also represent the first ten 
digits of hex numbers with the digits @-9. The next six digits 
are the letters A-F therefore we count in hex: 


co SN @) 


Oy pesto Oy Tororo ob eters 


Don’t be alarmed if this confused you. I have provided full 
conversion charts. Practice using these charts. You will 
eventually be able to add and subtract, even think in hex. You 
will see that the chart represents all decimal numbers @ to 255 
as @@ to FF hex. It is important to realize that hex numbers are 
always two digits (or some muliple of two) long, even though Tf 
show them as single digits above. That is only to avoid 
confusion over what the first sixteen digits are. Many hex 
numbers are obviously not decimal however when there could be 
confusion, you should show a ’h’ after the hex number (1@h). 
There is no ’d’ required for decimal as decimal is the default. 
Some operating systems use another character to represent hex 
(such as # or $) however, we will use a ’h’. You may find some 
hex numbers with an odd number of digits. In this case the first 
digit is a zero. Some assemblers require this notation in order 
to distinquise a hex number from a label. 

I will leave you with hexadecimal loaders for the TS102@ 
and TS2668. Enter the appropriate one for your computer and save 
it for use in subsequent lessons. This loader will serve you 
well while we are hand assembling our MC due to our routines 
being short. You do not need a full assembler until you are 
involved writing much larger MC routines or entire MC programs. 

The listings are self explanatory. You are prompted for an 
address in decimal, then begin entering your code in hex. Enter 
a's’ to stop. Your code is reflected on the screen to aid error 
spotting. The TS2068 will automatically save your code and clear 
the loader from memory, leaving your code above Ramtop. 
Unfortunately, that cannot be easily accomplished on the TS1@@@. 
We will discuss this in greater detail next time. 


72 


Listing 1 


10 For I = @ to 19 
26 Print I; Tah 6; Peek I 
30 Next 1 


Hex Loader TS1000 
10 Print “Enter start address in decimal” 


20 Input a 

30 Cls 

A@ Print "C 
50 Print 

60 Let af = 
706 If a$ = 

80 If ag = 

90 Poke a, 

100 Print a$ 
116 Let a = 

120 het ag = 
130 Goto 72 

1446 Save "MC 
150 Save "MC 


ode begins at "; a 


' then Input ag 
"s" then Goto 140 


16 * Code a$ + Code a$(2) - 476 


WICC 4) | a; 
artil 
a$(3 to ) 


it 


Hex Loader TS2068 
Gls: Input “Enter start address in decimal"; a: Cl 


ear a - 1: Pok 


Let a = Peek 23730 + Peek 23731 * 256 +1: 


ode begins at 
Let ag = "" 
“" the 


Poke a, 16 x ({ 

)})} + Code a$(2 

a$B( to 2);" 
Goto 44 

Let y=>art il 

Code x, y: New 


e 23658,8: Poke 23699, 390 
Rao bet <a e 


n Input a$ 


"S" then Goto 7@ 


Printr a 


Code a$(1) - 48 - (7 and a$({i) > "9" 
) - 48 - (7% and a$(2) > "9"): Print 


">> Let a =a+t+ i: Let aS = a$(3 to ) 


- X: Save "mc" Code x, y: Save "mc" 


<END> 
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Chart f 


Hex/Dec Conversions 
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alata aalatatedl Gebatatedl Getetatert tetetatad beetated tetatetel tetetated tatateted eetatete eet te eet et ee en eed | 
OY BET gr) 35 4 SMES! 7 tee To On ig imEte! 7b is Caaet 15 
ewan lane nl aan beeen Penne fae [---~ b+ -- 1 ---- 1 ---- fn nee ee fet 1 eee! 
{EGih TCP ME 1Gb19 1828 1 216! Spal 95 12d SMT poRei Maze oRtt 29 139 Test 
moon lawn name been bonne [aon bn Fenn | 4 --d nne | een nen -e 5 ~- b --- | -- ---| 
21521 351 3435! 3b 37 a! 39 ae ab ae ag tad as tag a7 
Se eae Stat Satan ea ate ater ae aes ed oe ed ed ee eed eed 
$1481 49 581511521551 4155! 58157 1581 59! oe tL! 42 | a8! 
wane fawn nl mn nn bane bmn Penn bn Fe ne be nn Ione been Leen pen tee beeen Lane tana! 
er, es i ee a se 
mee Pawn tn bmn me Penn bn ben beeen Lenn beeen Penne lane lnw ne nnn Panne lee! 
a a a he en ce 
wo ben | Pre Fw Pane bm Fen bmn Lin Fee Lene nnn lene ben den dannii 
6! 96! 97! 98 1 99! 108! 101! 182! 103! 184! 185! igs! fO7! tee! 1O9s Gia! tL 
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G1 128! 129! 13M! 131! 152! 133) 134! 135! 436! 137! 138! 392 142 14d! 24D! 143! 
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LESSON 2 


Last issue we discussed Hexidecimal (Hex) numbers and I 
left you with a machine code (MC) hex loader. You should have 
noticed these are very simple programs. That is to allow you to 
enter and debug them easily, as well as make whatever changes 
you desire. Please feel free to change them. 

We now need to explore the nature of MC. Since you are 
already familiar with Basic, I will draw some comparisons. The 
first difference is that MC does not use program line numbers to 
tell the CPU (remember him?) in what order to perform tasks. MC 
instructions are executed in the order in which they occur in 
memory. Even after a jump (Goto or Gosub), MC continues to 
execute the instructions sequentially as they are found at the 
address jumped to. 

secondly, there are about 700 MC instructions for the 2Z8@ 
as opposed to the 70 or 30 available in Sinclair Basic. Don’t 
let this scare you off. All 70@ instructions can be placed in 
about a dozen catagories and are therefore variations on a 
theme. We will confine each lesson to one of these catagories. 

The biggest difference is in how MC ’crashes’. Crash is a 
term used to describe the condition resulting from an involun- 
tary exit of the program (i.6. stopping with a full screen 
error, undefined variable error, etc.). When MC crashes there 
aré no error messages to aid us due to the fact that we are not 
operating within the confines of the Basic interpreter. Often 
the only recovery is to pull the power plug and begin again. For 
this reason, I reccomend you always Save your MC prior to 
execution. Saving it will not prevent a crash but, it does allow 
for easier recovery. 

There are two things to remember that will help prevent MC 
crashes. First, you cannot use the Break key to stop your MC 
routine unless it is reading the keyboard and accepting a Break 
instruction {not likely in most cases). Second, MC will not stop 
executing unless it is instructed to do so. MC will continue 
executing instructions (remember all numbers are instructions! ) 
as they are found. The easiest way to solve both problems is to 
end your routines with a ’return to basic’ instruction. 


We need to determine where we will store our MC as that is 
the first prompt in our MC Loader. MC can be stored almost 
anywhere, although above Ramtop is best, in the TS2@068 as it can 
save bytes as Code. Ramtop is a system variable which tells the 
Basic operating system how much memory is available and more 
specifically, what is the last available address in RAM. Ramtop 
is not necessarily the end of physical memory however, for Basic 
it is the top of usable memory. Also, all addresses above Ramtop 
are unaffected by new therefore, your routine cannot be erased. 
Rand Usr @ should be used in lieu of unplugging the power lead, 
if you later wish to clear all memory to the top of physical 
RAM. 

The TS5i@0@ presents special challenges. The best place is 
still usually above Ramtop however, the TS1@@@ cannot Save bytes 
from high memory. We will therefore store our MC in a Rem 
statement. There are other ways but this is the easiest to Save 
and execute for now. Later we will find that MC can still be 
most anywhere. 


The ease of execution from the first Rem statement results 
from our knowing the exact address at which the MC starts. 
Looking in the Sinclair manual section on memory storage reveals 
how a Basic program line is stored: 


high low low high 


SS a cl ES A A SG dh A i mei del fms obey 








' 2 bytes ! 2 bytes ! '1 byte! 

| ! i i } | ] 

Line no. Length of Text Enter 
Text + 1 


The first two bytes are the line number and note they are 
in direct oposite order of the normal storage of two byte 
numbers. The next two bytes are stored as the Z8@ would normally 
store numbers and represent the length of the text in the line 
plus the Enter, which is used by the Basic interpreter as an 
"end of line’ marker. Next follow the Basic text and finally the 
KROL marker. This makes the first byte after Rem the sixth byte 
in the line and in the program area if the line is the first 
line of the program. This address is 16514 in the TS1@@0 since 
the Basic program area begins at 16509. We will insure that we 
are working with the first line as follows. Type: 


1 REM ENTER, POKE 16519,0 ENTER 


We have also insured that our first line cannot be Edited even 
though it will still Save. 

The next thing we need to do is make space in our Rem 
statement to hold our MC. Refering to the chart above, the EOL 
marker is next after Rem, since we have not entered any text. We 
must never overwrite the EOL marker as we will cause an awful 
nasty crash. Type four lines of spaces after the Rem (you can 
figure out how to edit it) and Save your MC loader with your 
ijine @ to avoid retyping it next time. This is very wasteful of 
memory but, will serve us well for now. Your Rem statement need 
only contain the exact number of bytes you need when working 
within a program. 

We now need to know how to execute (Run) our MC. This is 
accomplished with the USR function. The Sinclair manual is a 
little vague on its use. The proper syntax is: 


Command USR X 


Where; Command=most Basic commands 
USR=USR function 
X=address to begin executing from 
Examples; RAND USR 16514 
PRINT USR 16514 
LET A=USR 16514 


Boy, this is sure good stuff but, I ain’t written no MC 
program yet! Well hang in there, we will get to the actual 
instructions next issue. Right now though how about aie sneak 
preview? 


You may have heard of such terms as opcodes, mnemonics 
assembly and disassembly. Opcode is short for Operation Code and 
is the Hex numbers we will be entering. They could just as 
easily be represented in decimal or binary however, we have 
chosen hex. 

Mnemonics are another shorthand which has been designed 
especially for us humans. The CPU understands a long list of 
numbers (opcodes) however I don’t. I do understand mnemonics as 
they are almost english (I did say almost). Look at the sample 
disassembly below to see what I mean. 

Assembly is what we will be doing when we convert our MC 
programs to hex. We will be ’hand assembling’ our MC. Assembly 
Language is another term for MC and is usually used to refer to 
the Opecodes. 

Disassembly is the opposite of assembly and is usually used 
to refer to a ’listing’ of MC instructions. You will probably 
want to disassemble someone elses MC after you understand what 
the mneumonics mean. That can help your understanding and 
learning of MC as you will already know what the program dcoes 
and will be able to see how the task at hand was accomplished. 
As in Basic, there is no single best way to program in MC. We 
all develope our own style (or lack of it). 

I will end this lesson with a sample disassembly. May we 
soon know what it means. 


Address L 1 Opcode nemonics Comments 
16514 start 3E@OA Ld A,@Ah ;Put MAh in A register 
16516 461@ Ld B,1i@h ;Put 1@h in B register 
16518 1/2) Add A,B ;Add @Ah & i@h and place 
16518 4 Ld C,A ;sresult in BC register 
1652¢ BEG Ld B,@ 
16522 done CS Ret ;Return to Basic 

<END> 
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LESSON 3 


Before we get to our first MC instructions, lets take 
another look inside our CPU. Inside we will find registers that 
Aregcam Cam AEB, CODE Mistiy lah @LA, ln, oP AP CeA gets Bos, Cie) 7s, homer? 
& L’. These are not the alphabet soup CPU had for lunch. 
Registers are merely storage places within the CPU as opposed to 
external memory (ROM & RAM). Think of these registers as storage 
boxes with names instead of addresses, much the same as you 
would Basic variables. 

mome of the single registers can be married to form 
register pairs. You are hereby ordained, by the power invested 
in me by the Great God 2480, as Justice of the Cpu, to form these 
unions as required. The permissable combinations are 
Al’, BC, DE, HOU y Abe, BC’, DE’? 0& sHL? (and you thought J"edidn’t know 
the alphabet! ). 

Single registers are similar to bytes in that they can 
contain any value @-255, Register pairs can contain any value 
@-65535 which makes them very valuable as address pointers. 
Refer to the discussion on addresses in lesson 1 for more on 
this. (contact TDM if you need back copies). We will use these 
Similarities to pass parameters (information) to and from our MC 
routines. 

On the subject of addresses and register pairs, you need to 
remember which is high and low. In memory (addresses) the first 
byte is low however, with register pairs the first register is 
high. This is easily remembered by knowing that the HL register 
pair was named with this in mind. H means high and L means low. 
An assembler will handle this for you but, we will have to watch 
it while we are hand assembling our code. Many crashes will 
occur because you forgot or confused the order of the high and 
low bytes or registers. 

nome of these registers have special names and/or jobs. 
Chart 2 lists some of these names/jobs. However, we will not 
discuss them further until we get to the instructions using 
them. 

Now for our first set of instructions (and you were 
wondering if I even knew any). Its mnemonic is hd, which is 
short for Load. Ld has no relation to the Basic LOAD command. Ld 
is an assignment instruction and acts very much like the Basic 
LET command. 

The proper ’syntax’ is Ld A,15. Which is read as ’Load the 
A register with the value 15’. Ld acts very much like the Basic 
bETSx= lon 

Take another look at the sample disassembly I left you with 
last lesson. Look at the comments and see if you can follow what 
is happening. It is a program that will return the sum of @Ah 
and 1@h to basic with’ the command: PRINT USR address. For 
practice, you can enter that program. Try poking the 2nd and 4th 
bytes with different values and run it again to see if you get 
the results you expect. If the sum is greater than 255 you will 
discover a bug I left for later correction. 


Note that we loaded the result into the BC register pair 
before returning to basic. This is due to the Basic operating 
systems’ handling of the USR function. It will always return the 
value held in the BC register pair. The value returned will not 
be the result unless you properly load BC before returning. 

Ld may not seem to be of much value however, in its many 
forms, Ld is the most used instruction. We can Ud most 
registers, register pairs or addresses with either a constant, 
the contents of another register(pair) or the contents of an 
address. Chart 3 details some of the many forms Ld can have as 
well as the proper ’syntax’. 

You will notice some instructions have parenthesis. The 
parenthesis signify ’the contents of’. For example; read the 
instruction Ld A,(40@@h) as Load the A register with the 
contents of the address 4@@@h. The Basic commands PEEK and POKE 
can be compared to these instructions. If the parenthesis appear 
on the left of the comma, you have a POKE operation and if they 
appear on the right of the comma, you have a PEEK operation. The 
Basic equivalent of Ld A, (49000h) is LET x = PEEK 16384, 
(400@0h=16384). Using this knowledge, the instruction Ld (49@@h), 
A is equivalent to POKE 16384,x. 

You will also notice a symmetry to the instructions. You 
can Ld r, (HL) and you can Ld (HL), r. This symetry will prove 
to be very useful and holds true throughout most of the 
instruction set. 

Note that some instructions seem to favor the register A or 
the register pair HL. This is due to their special functions 
(chart 2). There are simply some instructions that can only be 
performed with A or HL and no other register (pair). We will see 
that Ld is not the only instruction to exhibit this favoritism. 
This is not as restrictive as it first sounds, although you will 
on occasion wish for an instruction that does not exist. 

There’ is no need to detail the operation of each 
instruction as you should be able to determine approximately 
what can be expected from them, if you study charts 2 & 3 in 
conjunction with this lesson. We will discuss them further as we 
use them. It will be much easier for me to explain and you to 
understand their operation then. 

I am not listing the hex codes for all the Z28@ instructions 
we will use as this is not intended to be an exhaustive study 
but, 183 meant to give you a start. The first rung of the ladder. 
if you have not yet obtained a good book on the subject, you can 
find the codes in the appendix of your Sinclair manual. 

I cannot hope to give you all you will need in an article 
such as this. I must advise you to get a good book as ae study 
guide and to fill in where J] leave off. Rather than suggest a 
book that you may not like as well as I do, I would advise you 
to look at several. If possible, get several opinions but get a 
book. 

That’s it for now. Next issue we will discover the math 
instructions. The special significance of A and HL will be very 
obvious after that. 


<END> 


Chart 2 


Register Name Job 
A Accumulator accumulate the results of eight bit 
arithmetic 


directly access the contents of any 
memory address 


! 
| | 
! 
| | 
: ! 
F ! Flags ! holds various flags for CPU which 
! indicate the results of arithmetic 
| ! and logical instructions 
B ' eight bit counter 
BC ! ! sixteen bit counter 
DE ! Destination ! used for block moves 
AL ! High/Low ! sixteen bit arithmetic 
| ' directly access memory addresses 
| ! indirect address pointer 
Chart 3 
Registers | Register Pairs 
lid err Pelid srr nn 
Ldtsn ! fd ITX,nn 
!' Ld ITY,nn 
Ld A, (pq) ! 
Ld (pq),A : Ld (pqa),BC 
| Ld (pq), DE 
Ld r, (BL) | ld ¢pq) sHL 
La A, (BC) | Ld (pq), 1X 
Ld A, (DE) ' Ld (pq),l1y 
Ld (HL),xr 
Lad (BC}),A pe Ld" BC w( pa) 
Ld (DE),A 1 Ld DE, (pq) 
peud “ALC pa) 
Ld r, (IX+d) ' Ld IX, (pq) 
idirs, UlLyY +d ) i Ld IY, (pq) 
Lag ( [X#+d).3r 
La “(1Y¥+d),, x 
I 
Lid (HL),n ! 
Ld (IiX+d),n ! 
Ld (IY+td),n 


Where: r =any single register 
rr-any register pair 
nm =any numeric constant @-255 
nn=any numeric constant @-65535 
ad =any displacement @-255 
pq=any address @-65535 
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LESSON 4 


This time, right to business! We are studying the math 
instructions which are listed in chart 4. This is where it 
starts getting a little more difficult but, not so that you 
cannot handle it. Up to this point most of the lessons have been 
periferal background needed to make sense out of the rest of the 
discussion. 

We only have two math functions available to us, Addition 
and Subtraction. As with Ld, this is not as limited as it first 
sounds. A study of Math Theory would teach you that all math 
functions are performed with addition. I’1ll not try to explain 
this further as it would fill a volume larger than all the TDM’s 
published to date. The point we need to understand and absorb is 
that multiplication is performed by repetitive additions. 
Likewise, division can be achieved by repetitive subtraction. 

it 1S important that this make sense to you. Think about 
the multiplication problem of 12X6. It can be solved by either 
of the following: 


12 12 
x 6 12 
v2 12 


Can you see how we can solve division problems by 
repetitive subtraction? If we had the problem 72/12, how many 
times can we subtract 12 from 72? Is there a remainder? Simple, 
isn’t yet? 

This brings us to the first instruction, Add. We have 
already seen Add in operation, in Lesson 2, and probably have a 
good idea of its function. Trust me, it performs addition. Some 
of the later instructions will not be so obvious. We would read 
the instruction, Add A,E, as ’add the value in the E register to 
the value in the A register and store the result in the A 
register’. 

In lesson 3, we learned the A register is called the 
Accumulator. The A register is the only register that can 
directly ’accumulate’ the results of eight bit arithmetic. If we 
had wanted the result in the E register, we would need to assign 
it. Can you guess the needed instruction? You get an A if you 
said Ld E,A. Otherwise, go back to lesson 3. 

We also have available the instruction, Sub. The A register 
performs a special purpose here also. The A register is the only 
register we can subtract from. As with Add, the A _ register 
accumulates the result. You may see this instruction written as 
eub A,C or Sub C. They mean the same thing. We will use Sub C as 
the A register is always implied in eight bit arithmetic. 

I have mentioned several times that the A register will 
accumulate the results of sight bit arithmetic. We need to Leave 
the instructions for some more background. 


We have already learned that a single register may only 
contain a value in the range @-255. There is a condition, known 
as an ’overflow’ which occurs when these values are exceeded. 
The simplest way to describe overflow is by example. Let’s 
assume we are adding 255+1. We have not discussed number systems 
yet (that’s a later lesson) but let’s show our example in binary 
as it will demonstrate the point dramatically: 





Decimal Binary 
255 Lituriil 
vie. Yah + 1 
256 1 PUGAGBSSA 
Look closely at the binary example. Each digit represents a 
bit of the A register (or any other eight bit location). Assume 


for now that my answer is correct and you will note that we are 
now trying to place a nine bit number into an eight bit hole! 
The answer returned in this case would be @ instead of the 
expected answer of 256. Our example shows an eight bit overflow 
but, can you see how we can also overflow a register pair? 
(sixteen bits). 

Our friend, CPU, has a special register, F, which we 
learned stands for Flag. It is called this because its job is to 
keep track of various things for CPU. This is accomplished by 
the setting or resetting of a bit of the F register. Setting a 
bit makes it a1 and resetting it makes it a @. We will discuss 
this in some detail at a later time. 

The bits are referred to as flags due to the fact that they 
can indicate whether or not a certain condition exists. The 
flag we are interested in now is the Carry flag. We will also 
discuss the F register later therefore, we only need consider 
the carry flag now. 

In the above example, we found we would receive an answer 
of @. The ninth digit is not lost, as it is placed in the F 
register as the carry flag. In other words, the carry flag takes 
on the value (either 1 or @) of the overflow from our arithmetic 
operation. We will soon see why we would want to save the carry. 

Back to the math instructions. We have available the 
instruction ADC which is read add with carry. To see the 
difference, another example: 

Add A,E means Let A=At+tE 

ADC A,E means Let A=AtE+Carry (keeping in 
mind that the carry will again 
be set or reset by the result) 

ADC will allow us to chain together the needed additions to 
guarantee the correct result. Some of the same results can be 
achieved with the register pair instructions however, there can 
still be overflows. Study the following to see what I mean: 


Ld BL,@@4@Gh ibd H,OBh 
Ld BC, 7FFFh Ld L,4@h 
Add HL,BC Ld B,FFh 
Ld B,H Dat 2th 
bd ¢. i Ld A,L 
Ret Add A,C 
Ld L,A 
La A,H 
ADC A,B 
Ld B,A 
Loe Oe 


Ret 


Both of these routines will do the same job. Which makes 
more sense? Uses less memory? Executes faster? The point is that 
there are many ways to get the job done and many considerations 
to why we should choose one over another. 

We also have SBC or subtract with carry. This one is 
special because it is the only way to perform sixteen bit 
subtraction. We cannot Sub HL,BC. We must SBC HL,BC which 
implies we know the status of the carry flag. We may not know 
what’s on carry’s mind but we can clear the carry flag prior to 
performing a SBC by doing an addition that we know will not 
generate a carry. One that will work in all cases is Add A,®@. 
The value of A is unchanged and the carry flag is reset (@) or 
cleared as there is no overflow. We will find other ways to 
clear carry, soon. 

We need to be aware that HL acts as the accumulator for 
Sixteen bit arithmetic operations. HL has much the same favorite 
status with CPU as does A. The reason we need an eight and a 
Sixteen bit accumulator is that we cannot add or subtract 
registers from register pairs and vice versa. In other words, we 
cannot Add HL,A. It should be obvious that a sixteen bit result 
will not fit in A, however the reverse is not quite as obvious. 
If we wish to Add HL,A, what is the high byte? It simply will 
not work. 

The last instructions for this lesson are special cases of 
Add and Sub. They are Inc and Dec which are short for increment 
and decrement. Each will Ine or Dec by one. For example: 

Inc HL means Let HL=HL+1 
Dec HL means bet HhL=HL-1 

Armed with these new instructions, see if you can rewrite 
the addition routine we had in Lesson 2, to avoid the overflow 
error it contains. Make sure the last instruction is a Ret and 
use PRINT USR address to run it and return the answer to basic. 
see if you can write a similar routine to perform subtraction. 

A final note on the charts I am providing. This is the last 
time I will include the abbreviations comments. Also, you can 
usually substitute IX or IY for HL and (IX+d) or (IY+d) for (HL) 
therefore, I will not include them in the charts. 

Until next time, happy computin’. 


<END> 


syd Wyncoop 

2167 SE 155th 
Portland, Ore 97233 

(563)760-7786 


Chart 4 


Registers | Register Pairs 
Add A,r ! Add HL,rr 
Add A,n ! Add HL,SP 
Add A, (HL) ! "Adar lx er 
Add A, (IiX+d) ! Add IX,5SP 
Add A, (ITY+d) ! Add IY,rr 
leAdd LY #5P 
ADC A,r ! 
ADC A,n ' ADC HL,rr 
ADC A, (BL) ! ADC HL,SP 
I 
sub r : SBC HL, rr 
suben ; SBC BL,SP 
sub (HL) ! 
—incerr 
SBC A,r E*Incpor 
SBC A,n 
SBC A, (HL) ' Dec rr 
! Dec Sp 
Iie Conan ag ! 
Inc (HDG) | 
| 
Dec r 
Dec (HL) 


Where: r =any single register 
rr-=any register pair 
n =any numeric constant @-255 
nn=any numeric constant @-65535 
d =any displacement M-255 
Pq-=any address 


BEGINNING 2304 MACHINE CODE 
LESSON 5 


I left the last lesson with a challenge to you to rewrite 
the sample disassembly from lesson 2 to eliminate the overflow 
error it contained. If you had difficulty, refer to lesson 4. 
The answer was given in the comparison which explained the ADC 
instruction. How many of you thought of rewriting the routine 
using the sixteen bit instructions? Did you use LD HL,(pq) and 
LD BC,{(pq)? Can you see how a short Basic interface (program) 
could collect the values and call the MC routine to perform the 
addition? I trust some of you are beginning to have some ideas. 

We now know how to load a register (pair) or memory 
location and perform arithmetic with the values loaded. We would 
however, find MC of very limited value if these were all it 
could do. Most of you are familiar with the Basic commands GOTO 
and GOSUB. In truth, it is these instructions that give a 
program the power to do some real work for us. 

In MC, the equivalent instructions are referred to as Jumps 
and Calls. The syntax for these instructions is given in chart 
». You will note a new abbreviation, c, which is a test for the 
condition (or status) of a flag. 

We briefly discussed the Carry flag last lesson. Here is 
how the F (flag) register is arranged: 


Oeics Len 

Z = Zero 

H = Half-Carry 

P/V= Parity/Overflow 
N = Subtract 

CG = Carry 

-= Not used 


Sign Flag - Stores the sign of the last result. Flag will 
be set for a negative result and reset for a 
positive result (always reflects the most 
Signifigant bit of the result). 

Zero Flag - Checks whether last result was zero. Flag will 
be set if result is zero, else reset. 

Note: flag = 1 if result = @. Watch it! 

Half-Carry- Used internally by CPU to record carry from 
bit 3 to bit 4 in registers or bit ii to bit 
12 in register pairs. We will ignore it. 

Parity/Overflow- Has two jobs depending on the instruction 
last executed. 

Parity is the number of set bits in the result 


and is referred to as odd or even. Flag will 
be set if parity is even and reset if odd. 
Note: even parity generates an odd flag. Watch 
this one, also! 

Overflow records a carry from bit 6 into bit 7 
which effectively changes the sign or result 
in signed arithmetic operations. Flag will be 
set for overflow, else reset. 

Subtract Flag- Used internally by CPU to record whether 
last instruction was addition or subtraction. 
Flag will be set if was subtraction operation. 
We will ignore this one, also. 

Carry Flag- Our old friend records a carry from bit 7 to 
bit 8 in registers or bit 15 to bit 16 in 
register pairs. Is also used to save the lost 
bit in the shift and rotate instructions. 


You will note that two bits of the flag register are 
unused. The status of these bits is unimportant and there are no 
instructions that affect them. 

Each flag can be in one of two states, set or reset {on or 
off). A set bit = 1 (on) and a reset bit = @ (off). This can 
become very confusing when using the Zero or Parity/Overflow 
flags as the flag will not be as we expect it. For instance, the 
Zero flag = @ if the result was not aero. Most of the time 
however, you can use the flags without knowing whether they are 
set or not. You need only test their status and jump 
accordingly. 

Rach flag indicates a specific condition based on the 
result of the last instruction executed. Chart 6 indicates how 
the flags are affected by the various instructions. It is 
important to know how the flags are affected as every 
instruction does not affect them and many instructions do not 
affect them as you might expect. 


Knough of that, back to the Jump instructions. This 
instruction has two versions, Jump and Jump Relative. The 
mnemonics are JP and JR, respectively. 

JP is equivalent to Basics’ GOTO. JP begins executing the 
next instruction at the absolute address you specify as its 
argument. A JP 4@@@h instruction will send CPU off to address 
4060h to find the next instruction to execute. Your jumps can be 
conditional, that is, they can test one of the flags and jump 
only if the condition is met. 

JR requires the introduction of another Hex to Decimal 
conversion chart, Chart 7. You will note that the first half of 
this chart is the same as our previous Hex to Dec chart (lesson 
1). The last half however indicates negative numbers. When 
numbers are used in this fashion, they are referred to ’signed 
numbers’. Signed numbers merely means that the most significant 
bit (bit 7) is used to represent the sign of the number. A. set 
bit (1) is a negative number and a reset bit (9) is positive, 

JR also requires a brief discussion of the register pair 
PC. PC is a special register pair not normally accessible to us. 
It is called the Program Counter and its job is to keep track of 
where the next instruction to execute is located. All 2Z82 
instructions are 1,2,3 or 4 bytes in length. CPU will always 
advance PC by the correct number of bytes for the instruction it 


ls about to execute. The effect of this is to skip any arguments 
belonging to the current instruction so as to be in position to 
fetch the next instruction. 

Any jump instruction causes PC to discard the address it 
contains and replace it with the new address, as specified in 
the jump instruction. Note, PC will always contain the address 
of the next instruction to execute, not the current one. 

The JR instruction adjusts the PC by adding the value 
specified to the current value of PC. In other words, JR tells 
the CPU to Jump to address X, which is Y bytes from where PC is. 
Y can only be in the range of -128 to 127 and X is the 
calculated new address. In the case of negative values, the 
program would jump back to a previous instruction (loops) while 
positive numbers would cause the skipping over of the next Y 
bytes. 

JR can also be conditional as indicated in chart 5 and 
discussed above for JP. 

When programming in Basic, it is quite common to have a 
line such as: 

196 GOTO 1@x*xVAL A$+1000 

There is a MC instruction, JP (HL), which emulates this 
type of operation. This instruction will jump to the address 
held in the HL register pair. This allows a routine to build up 
an address from tables or inputs and transfer program control to 
that address. We will not discuss this much further now as it 
represents some pretty advanced programning. 

CALL is our GOSUB equivalent. It acts exactly like Basics’ 
GOSUB. A jump is made to the specified address and a return is 
made to the instruction that would have been executed next had 
the CALL not been encountered. This is accomplished by saving 
the address in PC on the stack (we will explain the stack later) 
before making the jump. 

There is a special case of CALL that does not require an 
address to be specified, which is known as RST. RST is read 
restart and 1S unique because it is the only instruction that 
uses an eight bit address. RST calls a subroutine with a one 
byte instruction. 

mome important points about RST are that it is uncondition- 
al and usually computer specfic (can not run on another 7Z8@ 
based computer). Being computer specific is due, unfortunately, 
to there already being instructions at all the RST addresses, 
which cannot be changed. This is due to our operating system 
being in a ROM type of memory. All is not lost though. Since 
these are very handy instructions, Sinclair put some of the most 
accessed routines there. We will find that we can use some of 
the RST instructions, after all. 

As with any GOSUB instruction, Calls and RSTs require a 
return instruction to let the CPU know the routine has finished 
its task. The mnemonic for return is amazingly enough RET. RET 
will perform exactly the operation you would expect it to and 
your returns can be conditional. Conditional returns allow for 
many exit points based on completing certain tasks. There are 
two special RETs which we will discuss later because they are 
used to return from the interrupts. 

We have learned about the flags and how to make jumps. and 
calls based on their status. We now need to explore some of the 
ways to set these flags in order for our tests to be meaningful. 
Qne of the ways to do this is directly with the CCF and SCF 


instructions. 

CCF means Complement the Carry Flag. If Carry was set, it 
will be reset and vice versa. 

SCF means Set the Carry Flag. The Carry flag will set by 
this instruction. 

Another way to affect the flags is with the remainder of 
the arithmetic instructions (I’ve been holding out on you 
again). These are also listed on chart 5 and can not truely be 
referred to as arithmetic instructions, except for CP. 

CP, which means compare, is a neat and often used instruc- 
tion. CP sets all the flags as if a value were subtracted from 
the Accumulator but, without changing the value of the accumu- 
lator! It is important to realize the result of the compare is 
not stored anywhere, only the flags are affected. 

CP has two special forms, CPI and CPD, which are read 
Compare with Increment and Compare with Decrement. CPI performs 
the same as a CP (HL) instruction would except that HL is 
incremented and BC is decremented. The only flag affected is the 
P/V flag which is set according to the value of BC. If BC =. @, 
then P/V = @. 

CPD is the same as CPI except that HL is decremented. the 
effect on the flags is the same. 

The next instruction is DJNZ which is not Greek. DJNZ igs 
read ‘decrement the B register and jump relative if B is not 
zero’. This is an extremely useful instruction which leads to 
the B register being used as a counter. DJNZ can be compared to 
the Basic loop control variable. The equivalent Basic statement 
would be as follows: 


10 For X = 10 to @ Step -1 
2a (do job here) 
30 Next X 


In order to perform the same operation as DJNZ using any 
other register, you would need two instructions: 


DEC L 
JR NZ, Loop 


To use DJNZ, you must properly load the B register. You can 
then construct a loop to do whatever task you wish. You can even 
reuse the B register in the loop, if you properly preserve its 
value first. More on this preservation of values later. 

CPL stands for complement. Each bit of the Accumulator is 
altered (complemented). For example: if the accumulator contains 
119111@1b, its complemented form would be @@10@@1@b. 

NEG is the last unexplained instruction on chart 5. NEG 
will negate the accumulator, which means to place the twos’ 
complement of the A register in the Accumulator. If the 
accumulator contains 5, it will be negated to -5. 

You now have about one third of the 280 instruction set 
and, with the stack instructions next issue, they are certainly 
the most used of the instructions. You are now armed with the 
tools to write a MC program of your own design. I encourage you 
to experiment and see if you get the desired results. TI will 
reply personally to all enquiries that contain a self-addressed, 
stamped envelope, if you have difficulty. 

With the next lesson we will explore printing to the screen 


as that will give us some immediate feedback as to how we are 
doing and whether our routine is working. If you have any 


information on the display file and/or ROM routines, you should 
review it, in anxious anticipation. 


<END> 


Chart 5 


mps ee: settin 
JP nn ! COF 
JP c,nn ‘OCH 
JP (HDL) 
ie CES nh 
JRe MP CRrr 
JR c,e ISCE*( HL) 
DJNZ ¢&© MeCeL 
| CPD 
CALL nn ! 
CALL c,nn THCPL 
RST xx 
! NEG 
RET ! 
Rie Dae i 
Where: n = any numeric constant @ to 255 
nn = any numeric constant @ to 65535 
r = any single register 
e = any numeric constant -128 to 127 
ec = flag status 
xx = O@h, O8h, 1M@h, 18h, 26h, 28h, 3@h, or 38h 


Parity changed according to result 


Chart 6 
Instruction(s)! € ' 2 !IP/V! S ! Ni! 9 ! Comments 
ADD, ADC rk 1k} Vo! ko! @ ! kx ! 8 bit add or add 
! ! ! Lew / tarry 
ADD aK Ol ae ol SO! a Gebit add 
ADC eet KT Va ORK! Ol = ) 160bit addfw/cearry 
AND 'O@!x ! Pix ! @! 1 ! Logical operations 
1B IgE ene tel eae elem ! 1 el eSpecitiedabit copied 
! | ! | into zero the flag 
RED te 2On, LT ee Ke eel I fT EBL Ce Nnstructions 
CCF Kt ee — et { ~ | @ ! ~ ! Complement carry flag 
SiG us Ke ae! ae! Om | eB! Set icarry flag 
CP, NEG, SUB, !' x! *x* !V!x ! 42! * ! 8 bit subtract or sub- 
SBGOMMDEG Ss" & | ! ! tract w/carry, compare 
INC | | | ! or negate accumulator 
| ' & 8 bit decrement 
DEC, & INC ! 1 eer fe ee lee = St Le ebitedecrement™and 
| ! { increment 
SBC p hoe! VE Kelas! — $816 bitesubtractaw/carry 
CELE CER; lo eee! Po! = ae loa leRlock searches j§Z=1 If 
CPD, & CPDR | | |! | ' A=(BL), else 2=@;P/V=1 
! ! ! | ! if BC not equal to @, 
! | | | ' else P/V=0 
CPL P- ! =)! = ! = 2? 1 ! 1 ! Complement accumulator 
DAA foe | * |} P !' kx ! - ' k ! Decimal adjust accun. 
IN pa ee ee | ce BI Py put rer Letter. direct 
IN Pf - }*e ! Pt k ! O@ ! @ ! Input register indirect 
INI, IND, Meme OR aah — TRL AL —* aie Block "inks out p,instruc- 
OUTI, OUTD, | ! | |! fetbions; 74-06 1f 6B is not 
INIR, INDR ! ! ! ' equal to @, else Z=1 
OTIR, G@yOTDR ! ! 
LD Po~ $- |} - | - ' = | = '§ Assignment instructions 
LDI, LDD, Coe te LEP Oe fe! Oo iepelock 8tiransters:a P/V=l 
LDGR Be LDDR.  ! ! ! ! ! ! if BC is not equal to @ 
| | ! f else P/V=-¢ 
OR, & XOR 'O@!*x | PP! * ! @ ! O@ ! Logical OR accumulator 
RLA, RLCA, re $ - | - § - ' @ ! O@ ! Rotate accumulator 
RRA, & RRCA ! | | ! | 
ROS "RLC, RRE fk tke ! Pt k ! 8 ! B® ! Rotate and shift left 
RRC, SLA, SRA, ! ! | ! OY Fae 
SRL 
Where: * = Flag changed according to result 
~ = Flag either unchanged or undeterminable 
O = Flag reset 
1 = Flag set 
Pr= 
ee 


Overflow changed according to result 
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Chart 7 


Signed Nugbers--Hex/Bec Conversions 


i Oitet i 2) St aiy 5 a a 7M peel eg uA Rem Ec ep tee tes 
tetera Cate catateted hetetetel Caleta tated ketetated tetetateD atetetet eateteteD etd eed eed eed eee 
PG a 2 OMe ehh tg U7 Pam ot igri iens 7b og 0 tame (Sa 
Natal testeteieal tetetentet Cetetateal Retetehal tatetated etetetent edatated tetatatet etait ete eee et ee eet ere 
146 ' 471 18) 19! WBE 21 E222 281 241 25 2h OT Bt 
Pawen Pew nn Tome tawee ann! ~~-- 1-1 en fan bane Penne |---| --+- 1-1 
132! 335341358 36 137 3B aR AL ft 42 8 4d) 48 45 fgg a7 
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148 491581 51152 153! 59155 ' 56157 1 58159! O8! bt 62 1 63 | 
Ferma bem mn Lee lm Fone been bani enn bonne lene beni! enn lennon nn bee et 
ee Ye ee, ee eT ee | 
Pawn Fawn Le | ne Fm Pen een nnn nn ben Pawan Fone loeb enn bonne lane! 
188! 811821! 8 1 BA! 85! Bb! BF! G2! O91 981911921931 94 gS | 
I i 
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LESSON 6 


This lesson we will discuss the stack and the instructions 
which use the stack. What is a stack? A stack is simply an area 
of consecutive bytes of memory which are used for storage by the 
CPU. The CPU cannot operate without a stack. We will find that 
we too can use the stack, if we are careful. 

Remember our earlier discussion of Rom, Ram and boxes? If 
not, you need some back issues! Think of our CPUs’ stack as a 
stack of boxes (memory locations). You can remove or add to the 
top of the stack easily but, try to remove or add a box 
somewhere in the middle and the stack topples. CPUs’ stack works 
the same way except it grows down from the top as if the boxes 
were suspended from the ceiling. Therefore, we actually add to 
the bottom of the stack. 

There is a special register inside CPU dedicated to keeping 
track of the stack. Its mnemonic is SP which means Stack 
Pointer. SP contains the address of the last location on the 
stack. 

All information on the stack is stored in the usual two 
byte format used for addresses. We can place information on the 
stack (PUSH) or remove it from the stack (POP). Our friend CPU 
automatically adjusts the SP with each operation by the required 
two bytes. It is important to realize that even though SP is 
adjusted to point to the correct location (box), the information 
is still there until it is overwritten. See figure 1 to make 
this clearer. 

The PUSH and POP instructions can add/remove information 
to/from the stack and any register pair. For instance, if we 
Wish to stack the contents of the B register, we need to PUSH 
BC. We will have also stacked the C register since, we must use 
a register pair. 

Last issue we learned the CALL instruction. It uses the 
stack to save the value of PC in order to know where to return 
to. In effect, CALL executes a PUSH PC, JP to new location and 
complete the subroutine, and then a POP PC (Ret) and continue 
executing the program from the byte after the CALL instruction. 

The , next instruction is Ld SP,HL. This is a simple 
assignment instruction. Whatever value is held in HL will be 
copied into SP, not the stack. Remember, most instructions 
assume all values on the stack to be valid addresses, even if 
they are data, so it is important to know where SP is. 

The last instruction affecting the stack is EX (SP),HL. It 
will exchange the contents of the address referenced by the SP 
with the value held in HL. Assume HL = 1@4@h and SP = 9@5@h = and 
address 9@5@h = 59 and address 905ih = 68. After the EX (SP),HL 
instruction is executed, their new values will be; HL = 6859h, 
oP = 945@h, address 945@h = 4@h and address 945ih = 1@h. Notice 
that SP is unaffected however, the contents of the last stack 
entry are changed. 

This is a good time to introduce the other exchange 
instructions. They are all fairly easily understood and are 


listed in the chart. Note that an exchange merely swaps the 
contents of the affected registers and no others, neither are 
any flags affected, except for the EX AF,AF’ instruction. The EX 
AF,AF’ exchanges only these registers while the more general EXX 
exchanges BC, DE & HL with BC’, DE’ & HL’. 

These exchange instructions do not actually change the 
register contents. Consider the EX AF,AF’ instruction. The AF 
register becomes the AF’ register and the previous AF’ register 
pair becomes the new AF register pair. This is important as the 
contents of registers can be stored out of the way for later 
retrieval. It also means we must be sure of which set of 
registers are in use. 

The EX DE,HL instruction is very useful and will exchange 
the contents of DE with the contents of HL. This is the same as 
if there had been an instruction to bd DE,HL and Ld H4HL,DE 
without disturbing any of the values. a series of PUSHes and 
POPs would be needed to accomplish the same result. For example, 
Lets EX BC,HL (there is no such instruction): 


PUSH BC 
PUSH HL 
POP BC 
POP HL 


Note that the information was moved from the stack into a 
different register pair than it originated from. This is a very 
useful tool to have at our disposal however, we must be aware of 
what we are doing or we may find ourselves expecting data at a 
location other than where it ended up. 

You will no doubt have noticed that I have rather 
laboriously explained the many instructions we have learned up 
to this point. The truth of the matter is that I have been 
trying to walk the fine line of too much detail/not enough 
detail. I hope there has been enough enough to get you started 
without boring anyone. 

We now have enough instructions to begin programming. I 
firmly believe the only way to learn any language is to use it. 
With that in mind we will concentrate more on accomplishing some 
task and less on the instructions. I must assume that if you are 
still with me, you have by now acquired some good books to 
supplement your learning. 

We will need to be able to ‘see’ if our programs are 
completing the task as we desire therefore, we will initially 
write programs that will affect the display file. This will 
necessitate two separate discussions as the TS10@®6 and TS2@68 
each handle their display files differently. You may wish to 
Skip the section which does not pertain to your computer but, I 
think you will find it beneficial to read. 

Before we jump right into it though, we need to take a look 
at the Sinclair manual again. Towards the back of the manual you 
will find a section on the systems variables. These are 
variables used by the Basic operating system to keep track of 
various items. Many of these will prove useful to us and several 
others are required to be under our full control. I will use 
~inclairs’ names and explain each one as we need it. You should 
take a moment to review this section of the manual as we will 
become intimate with many of the system variables. 
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The display file (D-File) 
characters. The last character 
(EOL) marker, which is Chr$ 


addition the very first character is 
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overwrite any of the EOL markers, 

This description only applies to a 


never ever, never overwrite 
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wince the D-File moves 
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rows of 33 
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Basic 
system 
This means that we can 


in memory as your 
its location is held ina 


always locate the D-File with the instruction Ld HL, (D-File). 


The easiest way to print to the D-File is to use the RST 
i@h instruction as that is where Sinclair has placed the print 
routine. RST 10h will print whatever character is in the A 
register. Enter the following to get a full screen of 
asterisks: 
isting ji 
OH16 Start La ¢Calsh ;line counter 
0620 Loopl Ld B,2@h ;characters/line counter 
3E17 Loop2 bd A,i7h ;character to print 
De Rat 1@h PEO SPLIN tet 
14rB DJNZ, Loop2 ;until Line is full 
™D Dec C ;count one line done 
ZOE6 Jr NZ, Loopl ;another line? 
Cg Done Ret ;return to basic 
While RST 16 is the easy way, it is only a minor 
improvement over Basic. That’s because we are using the same 
routine as Basic uses. The advantage is that we didn’t have to 


keep track of the EOL markers. 


The fastest way to print to the screen is by direct pokes, 


even from Basic. Enter the following for an almost instant 
screen fill: 
Listing 2 
cAVC4G Start Ld HL,(D-File) ;get D-File location 
OH18 bad €,18h ;line counter 
23 Loopi Inc HL ;Zet past EOL 
626 dl Bs 2On ;characters/line counter 
3617 Loope kbd (HL),17h ;poke character onto screen 
23 Ine HL ;advance print position 
LOEB DJINZ, Loap2 ,#@0 do again? 
AD Dec € ;count one line done 
ZOE 5 Jr NZ, Doopl ;do another line? 
Cg Done Ret ;return to Basic 


You should have noticed that 


on all lines. 


There is a system variable, 


this method allowed printing 
DEY_SZ, which can be 


poked from MC or Basic to allow full screen printing however, 
the system can be easily crashed if not properly handled. Also, 
the number i7h can be any print-able character code. 

Now for an all purpose, generic print routine: 


Listing 3 
1A Print bd A, (DE) ;check for EOL marker 
FE76 Cp 76h 
2001 Jr NZ, NoEOL 
13 Inc DE ;get past HOL marker 
TE NoHKOL Ud A, (HL) ;get character to print 
PREF Cp FFh ;check for end of text 
C8 Exit Ret Z sand return if reached 
ee Ld (DE),A sprints it 
Zo Inc HL ;advance character pointer 
13 Inc DE ;advance print position 
18F3 Jrairrint ;do it again 


The print routine is useless by itself. Upon entry, HL must 
contain the address of the first character to print and DE must 
contain the address in the D-File to print at. Enter the 
following routine to understand how you would set-up HL & DE and 
Call this routine at Print. 


Listing 4 

2ZAWC46 Entry Ld HL,(D-File) ;get D-File location 
EB EX DE,HL ;into DE 
210041 Ld HL, Text ,;@et address of text 

;address assumed to be 41@@h 
CD8240 Call Print ;HO print message 

;address assumed to be 4082h 
Co Done Ret ;return to basic 


And now a message must be stored at 41@@0h. Enter these hex 
codes to address 419@h: 


He i 


339 2D 2E 38 OB 2E 38 OG 26 BS 39 2A 38 39 1B 
06 2E 0@ 38 3A 37 2A AO 2D 34 35 2A BO 2E 39 
66 00 30 34 37 30 38 iB FF 


Note that the Print routine requires a terminating byte FFh 
in order to exit. Our test should now work with the command Rand 
UsrAlntrye 


TS 2068 


The D-File consists of 192 lines of 32 bytes/line for the 
character information and 24 lines of 32 bytes/line for the 
attribute information. The last 768 bytes are known as the 
Attributes File (A-File). The D-File is fixed in memory at 
address 40@0@h and the A-File resides at 58@@h. We will discuss 
the A-File at another time as its purpose is to hold the color 
attributes of each character square. We will therefore not be 
using the A-File at this time. 

The organization of the D-File is not what you would 
expect. Each character is eight pixels by eight pixels (one 
character square). The eight pixels across fit nicely in one 
byte, hence the 32 bytes across each line. The problem is the 
Gight bytes needed to make each character are not stored 
consecutively. Looking at figure 2 you can see that the D-File 
is split in three sections of 64 lines each. Within each 
section, the eight lines which comprise each character are 256 
bytes apart (8 lines * 32 character spaces). The junction of two 
sections is where there is a difference as the sequence begins 
to repeat. Study figure 1 to make this clear. I am told this 
unique structure has something to do with the way in which a TV 
draws its scan lines. Since I understand very little about the 
hardware, I must claim ignorance and accept the explanation. 

This means that the easiest way to print to the screen is 
by using RST 10h, which is where Sinclair chose to start an all 
purpose print routine. Once again though, things are not as easy 
as they would seem. The 24068 uses channels and streams to direct 
the traffic (we will discuss channels and streams later). This 
means that we must be sure we know where we are directing the 
output of ROT 10h or else we will have no idea where it will end 
up. 

Do not allow the D-File structure to put you off. We can 
still write to it if we understand its structure. Also, many of 
the routines we will need to help us handle it, are already 
located in the ROM. 

Let’s try a simple print using RST 1@h. Enter listing 1 
from the TS1@@@ area above and run it with Rand Usr address. 

You should get Error 5 on running this one. Notice how the 
bottom line is printed and scrolled. Probably not what you 
expected. We could call the channel open routine to fix this 
but, there is an upper/lower screen flag that can be temporarily 
set. If we reset bit @ of TVFlag, we can print to the uppper 
screen. Insert as the first two instructions: 


21 SC5G Ld HL,TVFlag ;get TVFlag address 
3686 Ld (HL) ,@@ ;reset flag 


Now run the routine. Works great! A much better way is to 
only affect the bit needed. This requires the instruction 
Res @,(1Y+@2), which we have not learned yet. You could also 
have achieved the same result with the first routine if you ran 
it with Print Usr address. This sometimes leads to undesireable 
results therefore, we will always use Rand Usr address or Uet 


x=Usr address. 

Lets attempt to poke a character directly onto the screen. 
{It cannot be done in one easy step as was the case with the 
TS1008. We must now resort to a complicated routine such as: 


Listing 5 

C630 MakeC Add A,3@h ;offset to make number 
;a printable character 

ED4B365C Print Ud BC, (chars) ;find character table 

E5 Push HL ;save character location 

2600 Ld H,@@6h ; transfer character 

6r Ld L,A ;to HAL 

29 Add HL,HL “Multiply aby: & 

29 Add HL,HL 

29 Add HL, HL 

QQ Add HL,BC ;get offset to character 
;data in table 

Ce: EX DE,HL ;address of data to DE 

ZABG5C Ld HL, (Store) ;we are storing address 
;in D-File to print at 
;in store 

B68 Ld B,@8h ;# of lLines/character 

1A Loop Ld A, (DE) ;get pixel data 

77 La (HL),A ;poke it to D-File 

a4 Inc H ;adjust print pointer 

gee Inc DE ;adjust data pointer 

1@PA DJNZ Loop ;are we done? loop back 
;if not, to complete 

ZiIBSG5C Ld HL,Store ;get and adjust print 

34 Inc (HL) ;position 

Bl Pop HL ;retrieve char location 

C9 Done Ret ;one character printed 


This routine is worthless without some data to 
another routine to setup the registers and call it. Notice 
there are two entry points. 
MakeC is used to print a number 
code (as in raw data, 
SCBMYh in the system variables area stores 
next print position. 


Print is the normal 
without having 
instead of text). 


print 


its 
Location 
address of 


The unused 
the 


entry however, 
character 


Upon entry to Print, we need to have the character to be 
printed in A. The HL register points to the character to print 
and needs to be preserved while Print is executing. Also, note 
that the program expects the data string to end with a byte 
containing FFh. Enter the following routine to set-up the 


registers and Call Print for a test. Your command to execute is 
Rand Usr Entry. 


Listing 6 
21ADBGAD Entry hd HL, 400@h ;lst address to print 
22 BOSC La (Store) ,HbL ;at into our variable 
213075 Ld HL,Data ;data string address 
;assumed to be 753@h 
TE Loop Ld A, (HL) ;get character 
PEFR CP FFh ;is it the end of 
;String yet? 
C8 Exit Ret Z ;ret if so 
CDAG8P Call Print ;else go print it 
;Print assumed to be 
sat 880Gh 
23 Inc HL ;advance char pointer 
186 Jr Loop ;get next character 


And here is the data as a hex dump: 


Hex Dump 2 


04 68 69 73 20 72 GF 75 74 69 GE 65 206 77 69 6C 
6C 20 6F 6E 6C 79 20 78 72 69 GE 74 28 69 6E 2@ 
SOF GE 65 2@ 74 68 69 72 64 26 GF 66 26 74 68 65 


29,13 63,72 65° 65¥6H426 61°74 20 61 GE T9 20.20 
74 69 6D 65 2E FF 


Be sure you have used the same addresses or change them to 
suit. If any address is not correct, you may crash. 
Well, that’s all folks. See ya next time. 


<END> 


Syd Wyncoop 
210 tmow 155th 
Portland, Or $7233 


Chart 1 
stack | Exchange 
Push rr |! Ex AF, AF’ 
Fopsrr PaExx 
Lad SP,8L 1 Ex DE,HL 
Ld Sr nn !- Ex 3( SEO AL 
DOmor al nn} 
Inc SP | 
Dec SP 
Figure 1 
Stack 
5 ele Se ali Assume the top two locations of the stack 
8S contain the address 80@0@h, that the SP is 
Se ae set at 6S1FEh and HL contains @C4@h. A Push 
41%) “oh sg HL instruction will load @C4@ in the next 
Ve ae re oe me me two stack locations, 61FDh and 61FCh, and 
: OC Dec SP twice, thereby making SP = 61FCh. 
NE i hd Ne A subsequent Pop HL instruction will then 
AQ) Inc SP twice while placing @C4@h into HL. 


it is important that even though SP has 
been adjusted, locations 61FCh and 61FDh 
still contain the address @C4@h and will 
until it is overwritten by another stack 
operation. 


| iil 


Figure 2 


Z@6B Display File Layout 
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Take first 3 digits from nearest edge 
Take 4th digit froa top/bottoa edges 
D-File addresses are net in brackets 
A-File addresses are in the brackets 


BEGINNING 230 MACHINE CopeE 


LESSON 7 


Before we begin, I need to ask again for some feedback from 
you. Especially if you are a TS1@@@ user. I have heard from no 
TS1i90@6 users and will concentrate the programming on the 2068 if 
you don’t speak up! The MC instructions are the same for both 
computers however, each program must be taylored to the 
operating system. This makes writing this series more difficult. 
Also, J need your ideas. What would you like to see? We are near 
done with 2480 instructions. 

Let’s talk about the logical instructions, And, Or and Xor. 
And and Or do not give the true/false response you are familiar 
with if you have used them as Basic boolean operators. Instead, 
they and Xor operate on the individual bits of a register, or 
other 8 bit location. Also, the flags are always affected 
according to the result of these instructions. 

Chart 10 provides the truth tables that explain how each of 
the logical instructions affects the bits being operated upon. 
While this makes the individual operations clear, it does little 
to help you understand the instruction, And F@h, when it is 
encountered. In order to understand these instructions better, 
it is neccessary to understand a little of Base 2 (binary) 
numbers. 


As we discovered in our discussion of hex numbers, the 
highest digit in any base is equal to base-1. This means that we 
have 2 digits in binary, @ and 1. The typical number 240 or F@h 
is 11119000@b in binary. The b denotes a binary number just as 
our h means hex. 

Rather than provide a full decimal to binary conversion 
chart, I have given you a hex to binary chart. This is because 
we have been working with hex numbers which are a very good 
shorthand for binary. Eight digit binary numbers are very easily 
represented by two digit hex numbers. I have provided program i 
for those of you wishing to generate your own charts. 

I think you will agree that all those 1’s and @’s of binary 
are begging for us to make an error. That being true, why do we 
want to represent numbers in binary? The reason is because the 
logical instructions operate on individual bits and these bits 
can be easily represented as set or reset (on or off, if you 
prefer) which is 1 or @, respectively. Binary provides an easy 
way for us humans to determine how our friend CPU will act. 

Let’s look at And. And is often used to mask off unwanted 
bits. Suppose our routine puts the result in the accumulator and 
we want to insure that the result is never greater than 7. We 
would do this with the instruction, And @7h. If A contains 52h, 
the And @fh would make A contain @2h. 


A = 91010010 
And @@@0@111 
A = QOGOGO19 


52h 
OTh 
2h 


hoki 


The result is always placed back in the A register. We have 
effectively said we only want to know about the three least 
Significant bits of A, therefore we have discarded the rest. 

Or is used to set the bits we need. If we wanted to insure 
the most significant bit is set we would Or 8@h. If we wanted to 
insure the most significant bit is reset, we would And 7Fh. Can 
you see where 1@@@@0@@@0b and @1111111b are more useful than 8@h 
and 7Fh with these instructions? Binary allows you to. see 
exactly what is happening. 


A = 01910016 = 82h A = @1@10@1@ = 82h 
Or 10000000 = 8Gh And 91111111 = 7Fh 
A = 11901@@1@ = Déeh A = @1@010@10 = 82h 


An example of using Or would be when we want to calculate 
an address. We would calculate the offset in A and then Or it 
With the high byte of the address to complete the calculation. 

Xor is not a fugutive from the Outer-limits! It is a 
special case that sets only those bits that differ. For 
example: 


A = 10010110 = 96h 
Xor 619011101 = 5Dh 
A = 119019011 = CBh 


This is referred to as complimenting. Xor is complicated and is 
not used often but it is handy at times. 


The bit manipulation instructions are the largest single 
group of 280 instructions. They are Set, Res and Bit. They are 
easily understood as they set, reset or test the status of any 
bit in any register or address. 

set and Res are the set and reset instructions respectively 
and they do not affect any flags. These instructions are useful 
when you need to set/reset a bit without affecting the other 
bits in that byte. You could use And and Or to accomplish the 
same task but often you will not know the status of the other 
bits. Set and Res avoid this problem. 

Bit is the test instruction. The bits are unchanged but the 
Zero flag is used to indicate the results of the test. The flag 
is set if the tested bit is zero, and reset if the bit is one. 


The rotate and shift instructions are also bit manipulation 
instructions. They are classified separately as they operate on 
the entire byte. Many of them use the Carry flag to store a 
Dit 

Rlea rotates the contents of the accumulator left one bit, 
Placing the sign (most significant) bit in Carry as well as in 
bit @. The effect of this instruction is to multiply A by 2. For 
example: ji 


1190819800b becomes 10010001b 


Graphically it looks like: 


Rla rotates the accumulator bits left though Carry. The 
Carry flag still contains bit 7 but the prior Carry flag is now 
in bit @. Here it is graphically: 


Rrea is similiar to Rlca. This time the accumulator’s bits 
are rotated right. Bit @ is copied into Carry and bit 7. The 
effect of this instruction is to divide A by 2. This one looks 
like: 


Rra is not surprisingly like Rla, except that we are 
rotating right. Bit @ is rotated through the Carry flag. Here it 
1s: 


S55 > S2 S— f Se ee a S e  e 

I 

Se SS + +--+ te 

Seaee >) “685 bas ois Si. tH=s===2=— >> 1Cyl => 
hm er ee ee +. +---+ 


The remaining rotate instructions will operate on any 
register (including A) or the contents of any address. Ric r is 
graphically the same as Rica. Rl yr is graphically the same as 
Rla. Rre r is graphically the same as Rrea. Rr ris graphically 
the same as Rra. The difference between Rra and Rr A is that Rra 
affects only the Carry flag while Rr A affects all the flags. 

The shift instructions are the true arithmetic instructions 
although they are otherwise similiar to the rotate instructions. 
The first, Sla is similiar to Rle instruction, except that the 
least significant bit becomes zero. The effect is to multiply 
the register or address contents by two. Graphically we have: 


+---+ $~---------------- + +---+ 


ora will shift right arithmetic the bits in the specified 
register or address. This is similiar to Rre except that bit @ 
is only copied to the Carry flag. Bit 7 remains as it was. The 
effect of this is to divide signed numbers by two, leaving the 
carry set if there was a remainder (you were dividing an odd 


number). Graphically, we have: 


5 esteeientanientententesbenttetenticterkedertonten + +--—+ 
==z===! 76543 2190 !=<=a=>! @ ! 
! $-----+------------ + +-~—+ 


orl, or shift right logical is the same as Sra, except that 
the most significant bit becomes zero. Graphically, this is the 
reverse of Sla: 


The last two shift instructions, I have never found a use 
for. They are Rld and Rrd, which mean rotate left decimal and 
rotate right decimal, respectively. They operate on the contents 
of the memory location addressed by HL and the accumulator. 

In the case of Rld (not to be confused with Rl ad) the low 
nybble of (HL) is copied into the high nybble of (HL), the high 
nybble of (HL) is copied into the low nybble of the accumulator, 
and the low nybble of the accumulator is copied into the low 
nybble of (HL). Got it? Here’s a picture: 


AbD iE 65 S (oe Ly Oe (HL). (a7) 67504 saci oO |! 
+----- Hw een ee + s hptaiatatatetetedakedatetettetedete ‘: 


For example, assume A contains 7Ah and (HL) contains 3ih. 
After an Rld instruction, A will contain 73h and (HL) will 
contain IA. 

Rrd behaves just as obnoxiously except, of course, that the 
rotation is to the right. Here it is: 


Remember, you will be limited to an eight bit answer with 
these instructions. The Carry flag will indicate an overflow and 
the accumulator, register or memory location will contain the 
difference. In other words, all arithmetic results will be 
modulo 256. 


Now, how about a practical application? Let’s develope a 
hex dump routine. We can show any byte as two hex digits once we 
know where to begin. We need the Basic interface first: 


Hex Dump Interface 


10 Print 


“Dump from decimal 


And now the Hex Dump routine for the 


address: : 
20 Input a 
30 Print a 
40 Print 


52 Poke base-1,Int (a/256) 
60 Poke base-2,a-Int 


(a/256)*256 


70 Rand Usr base 


75 Rem basezaddress of Hex 
Dump, substitute your addresses 


for base 


84 If Inkey$="" Then Goto 8@ 
946 If Code Inkey$=13 Then Goto 


7 


95 Rem 13=Enter on the TS2068 
Use 118 on the TS19@0 
100 If Inkey$="Z" Then Copy 


116 Goto 84 


TS2068. Remember 


use your addresses in place of the xxxx. 


Store 


FDCB@286 HexDmp 


Hau HexDmp-2 
Res @, (TVFlag) 


;this bit tells the Rom 
;routine to print in the 
;main screen area 


2AXXXX Ld HL, (Store) ;get address to begin dump 

GE1@ Ld €C,1@h ;counter-# of lines to dump 

TC OutrLp Ld A,H ;get the high byte of the 
;first address in this line 
;of the dumped bytes 

CDxxxx Call HexPrt ;€o print it 

7D Ld A,L ;get low byte of address 

CDxxxx Call HexPrt ;gO print it 

3E20 Ld A, 2@h ;ascii space 

F5 Push Af ;save the space character 

D7 Rst i@h ;print the space 

Fl Pop AF ;retrieve the character 

D7 Rst 10h ;print another space 

6668 Lda B,@8h ;counter-# bytes/line 

TE InnrLp Ld A, (HL) ;byte to accumulator 

CDxxxx Call HexPrt ;g0 print it 

3E2¢ Ld A,2@h ;ascil space 

D7 Rst 10h ;print the space 

23 Inc HL ;advance byte pointer 

1OF6 Djnz, InnrLp sloop for 8 bytes 

3EQD Ld A,@Dh ;ascii carriage return 

D7 Rst 1¢h ;g0 to start of next line 

1) Dec C ;count one line done and 

LOBED Jr nz,OQOutrbp ;loop for 16 lines 

ZEXKKX Ld (Store),HL ;store start of next line 


Print 


3 


Offset 


Ret 

Push AF 
And F@h 
Rra 

Rra 

Rra 

Rra 

Call Print 
Pop AF 

And @Fh 
Call Print 
Ret 

Cp @Ah 

Ccf 

Call c,Offset 
Add A, 3@h 
Push HL 
Push BC 
Rst 10h 
Pop BC 

Pop HL 
Ret 

Add A,@7h 
Ret 


;return to basic 


;save it 
;mask off high nybble 
sand rotate to low nybble 


;@0O print digit in A 
;retrieve it 

smask off low nybble 
;f0 print digit in A 
;ret to calling routine 


;check if digit is greater 
sthan 9 

;if so, set carry and 

;f0 adjust for correct 
;ascii character codes 
;make a printable char code 
‘save registers 


;Rom print routine 
;restore registers 


;return to calling routine 


;adjust digit to skip over 
sascii characters between 
;9 and A 

;return to calling routine 


And for you TS10@@0 owners (I still use mine!): 


2AT BAG 
O19 
7C OutrbLp 


HexDmp 


CDAS4@ 


Ld HL, (Store) 
Ld G,1@h 
La A,H 


Call HexPrt 
bd A,L 

Call HexPrt 
Xor A 

Push AF 

Rst 1@h 

Pop AF 

Rst 10h 

Ld B,@8h 

Ld A, (HL) 
Gall HexPrt 
Xor A 

Rst 1@h 

Inc HL 
Djnz, InnrbLp 
Ld A,76h 
Rst 1@h 


;get address to begin dump 
;counter-#of lines to dump 
;get the high byte of the 
;first address in this line 
;of the dumped bytes 

;f0 print it 

;get low byte of address 
;g0 print it 

;same as Ld A,WOh 

;save the space character 
;print the space 

;retrieve the character 
;Pprint another space 
;counter-# bytes/line 
;byte to accumulator 

;f0O print it 

;Bet space character 
;Print the space 

;advance byte pointer 

; loop for 8 bytes 

;get carriage return char 
;go to start of next line 


2D Dec C ;count one line done and 


20K 2 Jr nz,Outrhp ;loop for 16 lines 

22tB4@ Ld (Store),HL ;store start of next line 
Cg Done Ret ;return to basic 

F5 HexPrt Push AF ;save byte 

E6FO And F@h ;smask off high nybble and 
if Rra ;rotate to Low nybble 

iF Rra 

1F Rra 

1k Rra 

CDBA4@ Call Print ;f0 print digit in A 

Fi Pop AF ‘retrieve byte 

E6OF And @Fh smask low nybble 

CDBA4@ Gall Print ;#0 print it 

Cg Ret ;return to calling routine 
GC61C Print Add A,1Ch ;smake a character @ to F 
E5 Push HL ;save registers 

G5 Push BC 

D7 . Rst i@h ;Rom print routine 

Gi Pop BC ‘restore registers 

Bil Pop HL 

Cg Ret ;return to calling routine 


I have to assume that if you are still with me, you have 
obtained some good study aids. Since almost all books on the 
subject of 2486 MC have numerous tables in them, this is the last 
time 1 will give the hex codes in the MC disassemblies. I will 
instead, provide the source code. What’s source code? That’s 
another lesson. See ya soon! 


<END> 


Syd Wyncoop 
2107 SE 155th 
Portland, Ore 97233 


Truth Tables 


And Or Xor 
me SURGE PS tees | AP RE lee ee oe a 
@O ! @! OB O@ ! @ ! ji Bs re Ses": Neal ala 
Lin! OM}. 1 Le fel 14 - jal wl tied 


Hex/Bin Conversions 


ex Bin ! Hex Bin_ 
O BOO | 68 1060 
1 OOO1 { 9g 10901 
Z G1 | oA 1612 
3 4011 { B 1011 
4 C106 tea C 1100 
5 Cidi t 6D 1101 
6 6116 { &£ 1110 
7 Oiti i -F 1111 
Chart 11 
Logical a4 = a> ____!_ Rotate and Shift__ 
And r ' Rica 
And n ! Rla 
And (HL) ! Rrea 
Or r f Rra 
Or n ! Ric r 
Or (HL) ! Rle (HL) 
Xor xr Pe RL ar 
Xor n ! Rl (HL) 
Xor (HL) ! Rre vr 
' Rre (Hb) 
l Rrer 
Bit Manipulation. _ | Rr (HL) 
Bit bir ! Slar 
Bit b, (HL) t Sla (HL) 
Set b,r ! Sra r 
set b, (HL) ! Sra (HL) 
Res b,r ! Srl or 
Res b, (HL) ! Srl (HL) 
! Rid 
! Rrda 


Program i 


1@ LPrint “Dec Hex Bin” 
22 For i=-@ to 255 

106 Let h$=" “ 

116 Let hi=Int (1/16) 

126 Let h$(1)=Chr$ (h1+48+(7 

And hi>9)) 
1346 Let h2=i-hix*256 
149 Let h$(2)=Chr$ (h2+48+(7 


And h2>9)) 

200 Let b$="GISIGWGA" 

216 Let azi 

220 For n=? to @ Step -1 

230 If (a~2x*Int (a/2)) Then Let 
b$(nt+1)="1" 

240 Let a=Int (a/2) 

256 Next n 

306 Let t=(1 And i<10)+(1 And 
1<100)+(@ And i1<1006) 

319 LPrint Tab t;i;Tab 5;h$;Tab 
16;b$ 

320 Next i 


TS19@@ users need to change the following lines: 


126 Let h$(1)=Chr$(h1+28) 
146 Let h$(2)=Chr$(h2+28) 


a 
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LESSON 9 


It has been pointed out to me, by an astute reader, that I 
neglected to tell you to run your MC routines in SLOW, if you 
are using the TS190@. Otherwise, you cannot see the display of 
any of my examples. Sorry about that. 

This time we will discuss the I/O instructions. For those 
of you that are wondering what I/0 means, it is Input and 
Output. When I was new to computerdom, I thought I/O referred to 
my financial status. 

To what are we Inputing and Outputing? The computer, but it 
is actually our old friend, CPU. The I/O instructions allow the 
CPU to receive or send information through the concept of PORTS 
and they accomplish this depending upon how the manufacturer 
made the hardware surrounding the CPU. For example, in our 
computers port FEh is used for the keyboard. There are others 
used by Sinclair for the 2040 printer, cassette, and on the 
2068, for the bank switching and video mode changes. These are 
*hard-wired’ in the computer and supported by the operating 
system, therefore we cannot change them. 

What is a PORT? Very simply, it is the doorway though which 
information flows to and from the CPU and outside devices. There 
are 256 ports available to us on the 28@ (there are realiy 
65,536, but we will not consider them here). The ports are of 
course numbered @-255, as they must be referred to in ai single 
byte. Think of each port as a door to a storeroom. Each door has 
a number on it, much like a motel would. Each storeroom can hold 
one byte of data at a time. The CPU can put data in or take data 
out, by referring to each port (door). 

The I/O instructions are In and Out, respectively and there 
are two forms of the instructions, as detailed in the syntax 
chart. We are looking at some instructions that are almost 
english and fairly easily understood. 

The forms In A,(n) and Out (n),A use the port specified by 
n and reads (In) data into A or writes (Out) data from A. This 
is very similar to the Basic In and Out commands, except that 
the data is stored in the accumulator. None of the flags are 
affected by these instructions. 

For example: 


In A, (FFh) reads port FFh and places one 
byte of data into the accumulator 


Out A, (FFh) writes one byte of data from the 
accumulator to the device which 
is addressed by port FFh 


The forms In r,(C) and Out (C),r allow the flexibility of 
reading or writing data with any register. Caution, remember 
that C contains the port address. The Out (C),r instruction does 
not affect any flags, while the In r,(C) affects all the flags, 


except Carry, according to data which was read in. 
Register C must be loaded with the port address, prior to 
use, as in these examples: 


Ld C,F¥Fh reads port FFh and places data 

In B,(C) in the B register 

Ld C,FFh writes data from the B register 

Out B,(C) to the device addressed by port FFh 


You will note the I/O instructions assume you are communi- 
cating with some device (printer, monitor, disk, etc.) which is 
’addressed’ by a port number. The port number is selected by the 
hardware manufacturer, just as Sinclair did in our computers. 
You can perform I/O operations on all ports however, the results 
are unpredictable without a device attached. This is due to lack 
of pull-up resistors on the data lines. Obviously, there will 
not be any communication if there is no device attached or an 
incorrect port number is used. 

Since we have to contend with devices that are much slower 
than the CPU, we also have to consider timing. I will not get 
into this subject very deep, as this type of programming becomes 
very hardware dependent. 

The timing problem is obviously one of slowing down the 1/0 
operations, in an effort to match the device. Let’s consider the 
simple case of reading a switch. We might wish to read the 
switch once per second, to eliminate multiple switch closures (a 
good example is in debouncing the keyboard switches). 

We can perform this type of delay by looping for a prede- 
termined time period. A simple delay routine that can be used, 
without destroying any registers is: 


Delay Push BC ;save these registers 
Ld B,xx ;xx = # of ms to delay 
Diyi Ld C,yy >syy = 1 ms delay count 
Dly2 Dec C ;loop for 1 ms 
Jr NZ, Dly2 
DJNZ, Dlyl ;loop for # of ms 
Pop BC ;retrieve registers 
Ret ;end delay 


The value xx is the number of milliseconds to delay and yy 
is the number of loops needed for a delay of one millisecond. I 
will not take you through the steps of counting the delay as I 
wish only to demonstrate the technique. When you are ready to 
use this routine, you will not need my help with the values xx 
and yy. 

Another method of delay can be used with ‘’smart’ devices, 
such as a printer. This method uses two separate loops, instead 
of the nested loops we just looked at. Our example assumes the 
printer (actually, it’s interface) is wired for port 7Fh and it 
sends a zero byte when ready to accept data. 


Ready? Ld C,7Fh ;get port address 
in A,(C) ;@et ready status from printer 
Jr NZ,Ready? ;loop unless zero byte received 
Print Ld A,data ;get data byte to print 


Out (C),A ;send data to printer 


, 


Ret ;end delay 


This method has the advantage of not sending any data, 
unless the device is ready, therefore no data is lost. Can you 
imagine how this article would look, if some characters were 
lost in transit to the printer? No, that’s not what happened, I 
just write poorly. 

There is another solution to this timing problem, which 
uses hardware. We will not discuss that here, but you should be 
aware of it. 

You also note some I/0 instructions on the chart that I 
have not explained. These perform block I/O operations and will 
be explained next time, with the rest of the block instruc- 
tions. They are included here so that it will be clear they are 
I/O instructions. 

By now, many of you are undoubtedly trying to write your 
own MC programs. I wish to give some tips and hints, that will 
make the process less painful. 

First, DO NOT attempt to write a large MC program on the 
first try. Instead, take the approach we have followed here and 
write small routines that do a specific job. They can be easily 
called from Basic and will return to the next Basic line. I 
would suggest you take a small working Basic subroutine and try 
converting it to MC. An arithmetic routine is the easiest to 
convert, as long as it does not contain special functions, such 
as SQR, COS, etc. 

Write your MC in modules (subroutines) that can be easily 
tested and debugged. This also allows you to develope a library 
of known, debugged routines that can be used again. Look closely 
at the routines I have provided in this series. You will note 
that they are very similiar to each other. 

I do not flow-chart and will not describe that to you. 
There are many good books on the subject. However, before you 
begin codeing your routine, there are some questions you need to 
answer or data to collect: 

1)Purpose -what do we hope to accomplish? 

Z)Examples -what happens if? try several tests 
3)Inputs -what data does routine need upon entry? 
4)Outputs -what data is returned to calling program? 

I also strongly encourage you to document your program. All 
of us have purchased programs that were not user friendly, in 
spite of it’s claims, and in addition, had no documentation. 
This is deplorable, but the biggest reason for documenting your 
own programs is for ease of use. I have written code, been 
interrupted, and when I returned to it a few months later, I 
could not determine what the code did or why I wrote it that 
way! Some essentials to proper documentation include: 

1)Purpose -if the above questions were answered, 
they should be included here 
2)Registers -which ones are used? which ones are 
destroyed and which are preserved? 
what should they contain upon entry 
and exit? 
3)iInputs -what data does routine need upon entry? 
4)Outputs -what data is returned to calling routine? 
5)Routines Callled By -what routines use this one 
as a subroutine? 
6)Routines Called -what routines does this one call? 


7)Commented Source -an absolute necessity 

This is not the only information that should be in your 
documentation, but it is enough to make that routine useful to 
you next time around. Without this information, you will not 
develope a useful library of routines and will continually need 
to reinvent the wheel. If you follow these suggestions, you will 
find MC programming easy (well, almost) and if not, you will 
soon give up in frustration. 

Now, how about a short routine? Let’s convert binary 
numbers to decimal digits for printing. 

The easiest way to accomplish this is by repetitively sub- 
tracting powers of ten from our binary number and counting the 
number of times the subtraction is possible, better known as 
division. For the more advanced, try doing this by using the 
shift and rotate instructions. I am using the subtraction 
technique, as the code is much easier to follow. 


;Set-up Demonstration 
SOOO ORK KKK KOK KK 


;inputs: none 
;Outputs: print decimal number 
;Routines Called: Bn2Dec 
;Routines Called By: none 
;Purpose: set-up hl for our conversion routine 
Org 753@h 
Set-up Ld HL,40@@h ;hl=number to convert 
Call Bn2Dec ;g0 convert it 
Done Ret ;converted and printed 
;this is our return to 
;basic 


;our routine really begins here 


3 
;Convert Binary to Decimal 
5 KKK KKK KKK KKK KKK KKK KKK RK KK 


;inputs: HL=Binary Number 

;Outputs: decimal number is printed 
;Routines Called: Divide 

: Print 

;Routines Called By: Set-up 

;Purpose: convert binary number to decimal 
: ascii characters for printing 


Bn2Dec Ld BC,D8FOh ;-18,900 
Call Divide ;g0 get 10°4 digit 
Ld BC,FC18h ;-1,802 
Call Divide ;g0 get 10°3 digit 
Ld BC,FFSCh ~ ;-180@ 
Call Divide ;g0 get 1@°2 digit 
Ld BC,FFF6h ;-10 
Call Divide :go get 10°1 digit 
Ld A,L 5a = 10°O digit 
Exit Jp Print ;g@o print 10°O digit 


-Divide by 10*x 
SIO OKAOK 


; inputs: HL=Binary Number 

: BC=190°x 

;Outputs: A-=decimal digit to print 
;Routines Called: Print 

;Routines Called by: Bn2Dec 

;Purpose: divide binary number by power 
: of ten to obtain decimal digit 
; by repetitive subtraction 


Divide Xor A ;Clear our counter 
DvLoop Add HL,BC ;perform subtraction 
Inc A ;count it 
Jr C,DvLoop ;do again if possible 
Sbc HL, BC ;otherwise adjust the 
Dec A ,;counters for the extra 
;subtraction 
Ret Z ;division not possible 
DvDone Jp Print ;f0 print it 


7 
. 


¥ 
;Print Ascii Character 
SOGOOOIOKOIOK OOK KOK KOK KKK 


; Inputs: A=decimal digit 
;Outputs: digit in A is printed 
;Routines Called: Rom Print 
;Routines Called By: Bn2Dec 
Divide 
SPurpone: call rom print routine while 
: preserving the registers 


Print Push HL ;save all registers 
Push BC 
Add A,3@h ;2468 only 
;make an ascii character 
Add A,1Ch ; 1926 only 
;make an ascii character 
Rst 1@h ;@O print digit in A 
Pop BC ;restore registers 
Pop HL 
PrDone Ret ;digit has been printed 
End 


There are several things to note. First, since each routine 
is a separate module that could be called from anywhere, there 
are a few unneccessary instructions. For instance, the Jp Print 
is not needed at the DvDone label, as the Divide routine could 
simply ‘fall through’ to Print. I used Jp to demonstrate the use 
of another routine’s Ret instruction, in place of a Call Print 
and the subsequent Ret that would have been needed to end the 
Divide routine. Assume for a moment that Print does not follow 


immediately behind Divide. Try to follow the program through and 
see that the Divide routine uses the Ret instruction from the 
Print routine to return to the main routine, Bn2Dec. 

Also, I used the Rst 18h rom print routine for compatibil- 
ity on both the 1002 and 2868. Use of the rom routines often 
destroys the registers, therefore they were saved. Even BC, 
which we could have discarded. 

The source is written along the quidelines given above. You 
should note that the comments do not echo the instructions, 
except when it serves to clarify. I have seen many listings that 
look like: 

Ld HL, 49@@n > HL=480Ch 
Obviously not very informative or useful. 

Several lessons ago, I made the rather obnoxious claim that 
all arithmetic could be performed with addition. This routine 
will perhaps clarify that statement. We needed to divide. We 
chose to subtract, to achieve this. We chose to add a negative 
number, in lieu of subtraction. We divided! 

As a friend of mine says, "“Th-Th-Th-That’s all folks!", 
that is, until next issue. 


<END> 


Chart i 
sabes setae tee ees alee eat ee te pe le cee en ny res sera aa Oy 
In A,(n) ! Out A, (n) 
In r,(C) ! Out (C),r 
Ini ! Outi 
Inir { Otir 
Ind ! Outd 
Indgr ! Otdr 


Syd Wyncoop 
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LESSON 10 


The subject this time is the Z-8@ Block instructions. There 
are block instructions for I/0, search (compare), and transfer 
(assignment). We listed the block I/O instructions last lesson 
but they are detailed again in chart 1. 

Before we look at the instructions, we need to review one 
of the Z2~80’s flags. It is the parity/overflow (P/V) flag and is 
an overworked little devil, as it keeps track of two condi- 
tions, depending upon the instruction being executed. I gave you 
a chart of affected flags, by instruction, in lesson 5 (if you 
need lesson 5, contact TDM for a back issue! ) 

Overflow is similiar to carry except that it occurs only 
when there is a carry from bit. 6 to bit 7, of the accumulator, 
in signed arithmetic. The effect of an overflow is to change the 
sign bit of the accumulator. Overflow can be detected by use of 
the carry flag, but it is more difficult. 

The use of the P/V flag we are interested in is Parity. 
Parity is either even or odd and is simply a count of the set 
bits in a byte or register. An even number of set bits results 
in even parity and a set parity flag. Parity is indicated with 
the logical, rotate, I/O and all block instructions. 

The actual use of the parity flag in the block instruc- 
tions is to indicate when the BC register pair has been decre- 
mented to @ (see below). You will recall that 16 bit decrements 
do not affect the zero fiag. Since the 2-82 can indicate BC=9 in 
the P/V flag, it could have done the same in the zero flag, 
except that the zero flag already has a use in the block 
instructions (see below). 

There is one last piece of information we need in order to 
use the block instructions; how and which registers do we need 
to set-up? All the register pairs are used as follows. 

The BC pair is a 16 bit counter. The parity flag is set and 
the block instruction is terminated when BC=@. There is no 8 bit 
counter allowed, except for the I/O instructions, where B serves 
the purpose. 

The DE pair is a DEstination pointer for block memory 
transfers. 

The HL pair, as usual, is a memory pointer for all the 
block instructions. 

All the block instructions decrement BC and either incre- 
ment or decrement DE and HL, according to the type of instruc- 
tion. The third letter of the mnemonic will be ’i’ for § and 
increment or ’d’ for decrement. 

If the fourth letter of the mnemonic is an ’r’, then the 
instruction is functionally the same as the the 3 letter 
version, except that the instruction repeats until a counter has 
been decremented to @. 

Now for the instructions. I have listed the instruction (a 
few samples for each group) with its operation broken into 
"equivalent’ instructions, next to it. REMEMBER, the equivalent 
instructions are for clarification ONLY and are not executable! 


The first set is the completion of our I/0 instructions, 
from last lesson. 


Ini Indr 
Ld (HL), (C) Loop Ld (HL),(C) 
Inc HL Dec HL 
Dec B DJNZ Loop 


Notice that the block instruction is the same as 
the In r,(C) instruction from last lesson. The difference is 
that r can only be (HL) and the B register is a counter, hence 
the above ’equivalent’ instructions. 

Note also, how the auto repeat works. Since the repeat is 
part of the instruction, no other operation can occur in the 
loop (except, of course, interrupts--but that’s next lesson). 
The loop is not exited until B=. 

The block Out instructions are the same except that the 
byte pointed to by HL is moved Out port (C). 

The block search instructions are a variation of our old 
friend Cp (compare), as foliows: 


Cod Cpir 
Cp (HL) Loop Cp (HL) 
Ret Z Ret Z 
Dec HL Inc HL 
Dec BC Dec BC 
Jr NZ,Loop 


Note the additional exit point (Ret Z). These are called 
the block search instructions, as they will look at each byte 
and set one of two flags. The zero flag is set if A-(HL), (there 
is no Ret to anything) or the parity flag is set if BC-@. Since 
the Ret Z is for demonstration only, it is important to know 
that the operations on BC and HL will occur, even if a match has 
occurred. Therefore, you may need to adjust a pointer, after a 
match. 

For example, assume the accumulator contains FFh, HL 
contains 400@h and BC=@6h. This is the section of memory to 
search: 

Address Contents 


4000h OOh 
4001h 93h 
4QO2h F9h 
4903h FFh 
4004h C9h 
4@B5h Eih 


The search will end with the match at address 4@@3h and the 
registers will contain: 


A = FFh 
HL = 40@4h 
BC = @ih 


The zero fiag will be set, to indicate a match, and the 


parity flag will not be set, as we did not reach zero in BC. 

The last group of block instructions are for memory trans- 
fers (move one block of memory from here to there). They are 
essentially a variation on the assignment instructions (Ld) 
except that they work on two memory locations, instead of a 
register and a memory location. 

The registers must be set-up in advance for these instruc- 
tions to work properly, as follows: 


BC = size of block to transfer 
HL = first byte address of block to transfer 
DE = first byte address of new location of 


block, after transfer (DEstination) 


Once the registers are set-up, the instructions work like 


this 
Ldd Lair 
Ld (DE), (HL) Loop Ld (DE), (HBL) 
Dec DE Inc DE 
Dec HL Inc HL 
Dec BC Dec BC 
Jr NZ,Loop 


Note that we have only one exit to the loop, the case where 
BC=@. 

The following routine should be placed in your @ REM state- 
ment, to move your MC above Ramtop: 


Move Ld HL, Base ;Sstart address of your MC 
Ld DE,Ramtopt1 ;destination address above 
;Ramtop, where your MC will run 
Ld BC, Length ;length of your MC routine 
Ldir ;smove your MC above Ramtop 
Ret ;back to Basic 


One important point, any absolute addresses (Call nnnn, Jp 
nnnn, etc.) must be adjusted to indicate locations within the 
new block. The usual method is to assemble your MC to run at its 
correct location, then place it in the Rem statement for storage 
and SAVEing. This is the better method of saving and running MC 
from high memory on the TS1@00, than the method I gave last 
lesson. See if you can make a small change in the above routine 
to move your MC from high memory to your @ REM statement, using 
the Lddr instruction. 

The last caveat to watch for with transfers is overwriting 
& portion of your MC, if the blocks overlap. When there is an 
overlap of blocks, the bytes can often only be moved in one 
direction or from one end of a biock. For example, the routine 
above moves a block from start to end. It could just as easily 
been moved from end to start, using the Lddr instruction, if the 
pointers indicated the end of each block. 

The astute reader will begin to see some possibilities in 
these instructions, as they are fast and very powerful. You 
could, for instance, write your own ’find and replace’ routines, 
create ‘instant’ screen swaps or even animate a small section of 
the display (sprites). I’1l leave you with your imagination and 
the following routine. 


Our routine deviates from the instructions of this lesson. 
It is a renumbering routine for Basic programs and is given as 
a demonstration of what is possible and give you some more tech- 
nique. It will renumber any Basic program from a stated line 
(which must exist) to the program end. 

Many of the routines can be used in other programs, such as 
the input routine. It uses some error checking in order to avoid 
any non-numeric input. It also gives the method of converting an 
Ascii string of digits to a binary number for use in calcula- 
tions. It does however lack a backspace or delete. Can you see 
how to add it by reading one additional kKey press and adjusting 
the buffer pointer? Notice how the carry flag is used to 
indicate an error. Also, note that space must be left at the end 
of the routine for the input buffer. Do you want prompts 
anywhere on the screen? Run the Input routine with a PRINT USR 
address! 

Note that this program is written in rather large moduies, 
that fall through to the next one. It is extremely hard to debug 
a program written in this fashion, uniess you are using routines 
that are known to be bug-free. Can you see the obvious places 
for break-points, in order to test for debug purposes? 

Note how we reuse the string data for the Renumber prompt. 
But, enough of this. Here’s the routine: 


cates ladle ahead italy ubatyt LeLe SLL 


RENUMBER BASIC PROGRAM 
JAE IOI OI OIA RIO A TI IAI TAI IIIA 


Basic system variables: 
Prog Equ 5C53h 
LastK Equ 5C@8h 


‘ROM calls: 

KeyScan Equ @2El1h °TS108@00 = @2BBh 
LneAddr Equ 16D6h -TS1@@@ = @9D8h 
DeCode Equ @7BDh ;TS1800 only 
Org  FC@Gh -7S1900 = 7C@Ch 


;Test for a Basic Program to renumber for the TS2@68 


Start LD HL, (Prog) sno program line number has the 
BIT 7, (HL) ;ith bit set in high byte of line 
snumber, but start of VARS does 
RET NZ ;no program-return to Basic 


;Test for a Basic Program to renumber for the TS1906 


Start LD HL,4@7Dh ;start of Basic program area wiil 
LD A, 76h ;contain an ENTER (chr$ 118) if no 
CP (HL) ;program as will be first character 
RET 2 ;of the display file 


-This is common code for the 1000 and 2068 
;Get data for renumbering 


G_ From CALL PrRnum ;prompt for Renumber from line # 
LD HL, FrombLn 
CALL Print 
CALL Input ;@0 get line # 
JR €C,G_From sbad input-do it again 
LD HL,OldLine ;save input in this variable 
LD (HL),E 
INC HL 
LD (HL),D 


;Now, get the first new line number 


G_ New LD HL,NewLn ;prompt for Start with new line # 
CALL Print 
CALL Input ;f0 get line # 
JR C,G New ;bad input-do it again 
LD HL,NewLine ;save input in this variable 
LD (HL),E 
INC HL 
LD (HL),D 


;And, finally the step for the new line numbers 


G_Step CALL PrRnum ;prompt for Renumber in steps of 
LD HL,Iner 


CALL Print 
CALL Input 
JR C,G_Step 
LD HL, Step 
LD (HL),£ 
INC BL 

LD (HL),D 


- Search for first line 


Search LD HL, (OldLine) 
CALL LneAddr 


JR Z,ReNumb 
LD HL,NotFnd 
CALL Print 
RET 


“Begin renumbering 


ReNumb LD DE, (NewLine) 
LD (HL),D 
INC HL 
LD (HL),E 
INC HL 
PUSH HL 
LD HL, (Step) 
ADD HL, DE 
LD (NewLine),HL 
POP HL 
LD E, (HL) 
INC HL 
LD D, (HL) 
INC HL 


ADD HL,DE 


BIT 7, (HL) 
RET NZ 
LD A, 76h 


CP (HL) 
RET Z 


JR ReNumb 
Print routines 
PrRnum LD HL,Renum 


Print LD A, (HL) 


;fO get step in lines 
‘bad input-do it again 
;save input in this variable 


to renumber 


*-set-up HL for Rom routine that 
;returns the address of the line 


swhose number is held in HL, in the 
-HL register pair, or the line that 
sfollows it, if it does not exist. 


‘The start of the previous line i 
sreturned in DE. The zero flag is 


Ss 


;set if the line number was found. 


;found it-ok to continue 
snot found-give error msg 


sand return to Basic 


;get the next new line # 
;load it into the present 
sline # bytes 


;advance pointer 

;save it 

;g@et step between line #’s 
;and adjust the next line # 


;put next line # back in variable 


;retrieve pointer 
;get line length into DE 


;adjust pointer to start of Basic 


;line (after line # and length) 
;add line length to pointer to 
;adjust for start of next line 


;test for valid line # or ;2068 
;Start of Basic variables ;2668 
‘return to Basic, if done ;2068 


‘test for valid line # or ;1900 
;start of D-File ; 1800 
;return to Basic, if done ;1800 


;@0 do next line 


;special entry to print the word 
*‘Renumber (this saves data space) 
;HL=pointer to step thru messages 


only 
only 
only 


only 
only 
only 


; Input 


Input 


CP FFh 
RET Z 
PUSH HL 
RST 1@h 
POP HL 
INC HL 
JR Print 


routine 


LD HL, Buffer 
LD (Pointr),HL 


;check for terminating byte and 
;exit routine if found 

;save pointer 

;rom print routine 

;retrieve pointer 

;and adjust it 

;loop to print next character 


;storage for input 
;reset buffer pointer-effectively 
;Cclearing the buffer 


:This is for the TS2068 only 


Scanky 


LD A,FFh 

LD (LastK),A 
CALL KeyScan 
LD A, (LastK) 


;Cclear last input character 


,;use rom routine to get key pressed 
;g@et newly pressed key code 


>This is for the TS10@0 only 


ScanKy 


NewKey 


CALL KeyScan 
INC L 

JR NZ,Scanky 
CALL KeyScan 
PUSH HL 

POP BC 

INC L 

JR 2,NewKey 

CALL DeCode 


LD A, (HL) 


suse rom routine to get key pressed 
;and check for heavy-handed human 
sto lift finger 

;use rom routine to get key pressed 
;which is returned in HL but, 

;is needed in BC for DeCodeing 
;check and wait for a new key press 


,;rom routine to decode key press, HL 
;will point to proper key in the rom 
;key table 

;put keycode into A from table 


This is common code for the 19006 and 2068 


3 


DigtOk 


Endinp 


CP @Dh 

JR Z,Endinp 
CP 3h 

JR C,ScanKky 
CP 3Ah 

CCF 

JR C,Scanky 
LD HL, (Pointr) 
LD (HL),A 

INC HL 

LD (Pointr),HL 
RST 1@h 

JR Scanky 

LD HL, (Pointr) 
LD (HL),A 

RST i@h 


;accept ENTER (10@00-76h) 

;and end input if so, else 

;check for and accept only (10@0@=1Ch) 
;the digits @ to 9, else 

; (19000=26h) 


;continue scanning the keyboard 
;input has been accepted-retrieve 
;buffer pointer and store digit 
;adjust pointer for next digit 
sand save it 

;echo accepted key press to screen 
;scontinue input 

;retrieve the buffer pointer 
;Store ENTER in buffer 

;advance print position to next line 
;on the screen 


;we now have accepted, verified and 
;ended our input but it needs to be 


‘converted from a string of Ascii 
‘characters to a single word Binary 


;snumber. 
Asc2Bi LD HL, Buffer ;get start of input buffer 
. LD A, (HL) sand first character 
CP @Dh *check for input of ENTER only (10006-76h) 
JR Z,Error ‘and goto error routine if found 
SUB "@ ;good character-make it binary 
PUSH HL "save pointer 
LD DE,®@ *set-up for first run through loop 
LD B,@ *set-up for later use in BC 
Muilti1@ LD C,A ;save current digit 
EX DE,HL ;retrieve ’last value’ of converted 


>binary number-note: it is @ at first 
;and place it into HL 


ADD HL,HL ;double it 

LD D,H ;store HL*2 in DE 

LD E,L 

ADD HL,HL ;double again 

ADD HL,HL -and one last time 

ADD HL, DE sadding HL*2 means HL=HL*1@ 

ADD HL,BC ;add the current digit 

EX DE,HL ‘temporarily store ’last value’ 

POP HL ;retrieve pointer 

INC HL sadjust it 

LD A, (HL) ;get next digit 

CP @Dh ‘check for terminating ENTER (19000-76h) 

RET 2 ‘and exit if found 

SUB "@ ‘good character-make it binary 

PUSH HL ‘save pointer 

JR Mult1@ sloop back to multiply by 104 
Error LD HL, InpErr ;load bad input msg and 

CALL Print sprint it 

SCF ‘Signal error occurred 

RET ;return to main routine 


;Program Messages 


Renum DEFB @Dh ;1906-76h 
DEFM “Renumber " 
DEFB FFh 

FromLn DEFM “from line #:" 
DEFB FFh 

NewLn DEFB @Dh > 1@00=76h 
DEFM “Start with new line #:”" 
DEFB FFh 

Incr DEFM “in steps of:" 
DEFB FFh 

NotFnd DEFB @Dh *1900-76h 


DEFM "Sorry, I cannot locate the line” 
DEFM “to renumber from! !" 
DEFB @Dh,FFh °1000-76h,FFh 

InpErr DEFB @Dh ;1006-=76h 
DEFM "“*xxxInvalid Input-~--Try Again***x*" 
DEFB @Dh,FFh >1000-76h,FFh 


;Program Variables 


OldLine DEFW @ 
NewLine DEFW @ 
Step DEFW @ 
Pointr DEFW @ 
Buffer DEFB @Dh ; 1800=76h 


